Janus Emulator

Newbie Spellweaver
Joined
Mar 12, 2024
Messages
57
Reaction score
159

1775436600097 - Janus Emulator - RaGEZONE Forums

Janus Emulator - v0.1.0 Public Beta

GitHub:

| | |


What is Janus Emulator?​


Janus (codename ProjectPAULA) is a C++ server emulator for Trickster Online, built for the Korean Paula client (2014).

The goal is a 1:1 recreation of the original Paula servers, not just a server that looks like Trickster: the same formulas, the same timings, the same packet layouts and even the same quirks. Every system is reverse-engineered from the original server binaries and game data, and every packet the server sends is checked against the client before it ships. Where Janus has to behave differently from the original, the difference is marked in the code.

v0.1.0 is the first public release. The source code, a ready-to-run server package and the PaulaLauncher are on GitHub, so anyone can host a server and play. Everything marked (done) below has been tested and validated in game with the real client.


Quick Start​


Hosting a server
  1. Download ProjectPAULA-v0.1.0-server-win32.zip from the (or build it from source with Visual Studio 2026 + CMake).
  2. Install MariaDB and run install-db.bat to create the database.
  3. Create your players' accounts with tools\add-account.bat <name>.
  4. Set your public IP in the confs, open TCP ports 9980, 8001, 8002 and 8003, and start run-server.bat.
Step by step:

Playing
  1. Use your own KR Paula client (the guide lists the supported build).
  2. Download ProjectPAULA-v0.1.0-launcher.zip and put PaulaLauncher.exe and launcher.ini next to Trickster.bin.
  3. In launcher.ini, set LoginIP to the server's IP and Account to the account name the server owner gave you.
  4. Start PaulaLauncher.exe.
Step by step:


Tech Stack​

  • Language: C++17, about 52,000 lines
  • Networking: standalone Asio (async TCP)
  • Database: MariaDB 10.2+, installed by 19 SQL scripts
  • Game data: 67 human-readable YAML databases (rAthena-style): items, monsters, drops, skills, quests, shops, NPCs, maps and more, plus 685 map files
  • Build: CMake + MSVC (Visual Studio 2026), 32-bit
  • License: GPL-3.0

Architecture​

Janus follows the original server layout:
  • AuthServer: account login and the island list
  • LoginServer: the character screen (list, create, delete, select)
  • MasterServer: the database hub and the link between the servers
  • GameServer: the world (maps, monsters, combat, items, skills, NPCs, quests and parties), plus the community connection used by party, whisper and friends


What's New in v0.1.0​

  • First public release: the server package, the PaulaLauncher, database install scripts, start and stop scripts, and full documentation (install guide, player guide, configuration reference, GM commands, feature list).
  • Ready for public servers: unknown and banned accounts are refused, every entry into the world needs a one-time ticket from the character screen, server-side checks against item and gelder duplication, hardened packet handling, and a clean shutdown that saves every player.
  • New systems since the last update: player trade, whisper, friends, post box and level gifts, pets, the Polar Bear line, party quests, megaphones, Memory Port, monster and pet speech, refine and mature compound.


Feature Checklist​


(done) tested and working in game
(planned) not in v0.1.0 yet

Core & Login​

  • Session encryption (SESSION_ENCRYPT / SESSION_OPEN handshake) and packet cipher (done)
  • Login with account checks (unknown and banned accounts are refused) (done)
  • Island list and server selection (done)
  • Character list / create / delete / select, with the original rules and starter kit (done)
  • Community connection (party, whisper and friends) (done)
  • Saving every 15 seconds, on every map change and at logout (done)

World​

  • Zone entry, map loading and map changes through portals and teleports (done)
  • Movement with the original walk and run speeds (done)
  • Other players and monsters shown and moving in real time (done)
  • Monster spawns and respawn (done)
  • Monster AI (passive and aggressive monsters, wandering, aggro, chasing) (done)
  • NPC dialogs, menus and teleports (done)
  • Sitting and resting (HP / MP regeneration) (done)
  • Monster speech (done)
  • Shadow monsters and the Third Eye (done)

Combat & Progression​

  • Melee combat with the original formulas (hit, evade, block, critical) (done)
  • EXP per hit, TM per kill, level and TM level ups (caps 400 / 500), stat points (done)
  • Skill system with buffs and debuffs (done)
  • 251 of 305 class skills, plus the 26 Polar Bear skills (reconstructed: the original server has no code for them) (done)
  • Party skills: auras, heals, party buffs and Bodyguard (done)
  • Skill cards, skill scrolls and skill masters (job change and mastery) (done)
  • Death, return to town and resurrection (done)
  • Guns and ammunition (done)

Items & Economy​

  • Monster drops, gelder and loot ownership (done)
  • Pick-up, inventory and weight limit (done)
  • Equipment (23 slots) (done)
  • Rare items with random options and compound slots (done)
  • Potions and dropping items (done)
  • Special items: gift boxes, teleport items, stat and skill resets, hair dye, disguise kits, rename, Memory Port and megaphones (done)
  • NPC shops and exchange shops (done)
  • Warehouse and account bank (done)
  • Compound, refine, repair and mature compound (done)
  • Drill digging and Crazy Drill (done)
  • Pets and pet speech (done)
  • Card items, throwing items and rental items (planned)
  • Treasure maps, seeds, rune stones and the other remaining special items (planned)

Social & Quests​

  • In-world chat, whisper and megaphones (done)
  • Friends (list, groups, notes, Friend Finder) (done)
  • Party: invites, party chat, EXP and TM sharing, division modes, item sharing, reconnecting members, join requests and the party board (done)
  • Party quests (done)
  • Normal, scenario and monster quests (done)
  • Player trade (done)
  • Post box and level gifts (done)
  • GM commands (@item, @warp, @spawn, @speed, @skill...) (done)
  • Chat rooms and private shops (planned)
  • Guilds (planned)

Coming Later​

  • PvP (planned)
  • MyCamp (housing) (planned)
  • Couple / marriage system (planned)
  • Mounts and Soul Shade (planned)
  • Time capsule (hibernation) and rankings (planned)
  • Account passwords (planned)


How Faithful Is It?​

A few examples of original behavior that Janus reproduces:
  • EXP is earned on every hit, based on how much of the monster's HP you took. TM is only earned when the monster dies, and only by the player who hit it first.
  • A monster belongs to the first player who hits it: other players can't attack it, unless they are in the same party.
  • Party EXP is shared only between members on the same map, with a bonus that grows with the number of members and depends on the party type.
  • A party member who disconnects stays in the party list and rejoins automatically when logging back in.
  • Most buffs can't be used in towns, indoor maps and minigames, exactly like the original.
  • Firing a gun faster than the gun allows is ignored, and doing it three times in a row ends the connection: the original anti-cheat.


Good to Know (v0.1.0)​

  • No passwords yet: the client sends no usable password, so the account name is the login. Server owners create the accounts and should hand out names nobody can guess.
  • Paula client only: the Season 2 client is not supported in this release.
  • Original rates: EXP, TM, gelder and drops are the original 1x values, plus the original party bonus.
  • Some NPC dialogs and all monster and pet lines are still in Korean, as in the original data.
The complete list, including the original quirks that are kept on purpose:


Contributing​


The project is in active development. If you played Trickster Online and want to help with:

  • Testing with the KR Paula client (bug reports go to )
  • Reverse engineering
  • Packet captures (old logs from the official servers are gold)
  • Database research (item, skill and quest tables)
  • C++ development
...feel free to reach out. Found a security issue? Please report it privately (see ) instead of posting it.


Janus is a fan-made, non-commercial preservation project. It is not affiliated with the owners or publishers of Trickster Online and does not distribute the game client.

1775369327729 - Janus Emulator - RaGEZONE Forums
 
Last edited:
i found official korean ntreev installer from 2011 do you want it?
I appreciate it, but I actually have the 2012 one! The problem is that Paula isn't in that version, so I really need a client from 2013 onwards. She was released in early February 2013, so the exact client I'm looking for would be from January 2014, just a few days before her 1st anniversary.
 
Well, I made some good progress today.

I wanted to thank altasking and habboplayer for helping me with the Korean client, that was really important.

Now the emulator will only be compatible with the Korean client.
You can choose between the PAULA and PRE-PAULA versions.

I've already had some success with character creation and listing, but there are still a few bugs I'll be fixing over the next few days. I'm really looking forward to starting to code the actual in-game features.

1775369699682 - Janus Emulator - RaGEZONE Forums




I think i cant double post, so... Character Creation are working fine now!!

1775419733680 - Janus Emulator - RaGEZONE Forums
 
Last edited:
i found 3 more official game client installer do you need them?
they are from 2013 before trickster online shutdown january 28 2014
 
I spent the whole day today reverse engineering the map entry functions (loading from the character selection screen). I made good progress, but I haven't fully cracked it yet... still digging into it, though... On the bright side, the character selection functions already have a solid foundation, so I'll be refactoring that code soon.

1775454367195 - Janus Emulator - RaGEZONE Forums


open source?
Yes, but not just yet. I want to ensure the servers are stable and clean up the codebase and docs before making it public.

i found 3 more official game client installer do you need them?
they are from 2013 before trickster online shutdown january 28 2014
I really appreciate it, but I already have the 2013 pre-Paula client and the final Jan 2014 client.
Thanks anyway!
 
i previously dev on korean mmo and i think you can use so those text ???? are readable ... you OS is missing Korean language pack
 
open source trickster online server is complicated than i thought so many system pet,item forging, item refinement, item fusion, card, drilling, ...etc
 
Last edited:
I am also doing something similar to this project, but I couldn't find a client from 2013-2014. Would you give me the link of where you found it if you don't mind please?
 
i dont know if it helps but i found in my archives the KTO 2014.01.28 CLIENTE
Thanks for confirming the client's map files are complete with nothing missing.
Attached are the decrypted contents of libconfig.dat from this version, along with the map portal (warp point) data.
 

Attachments

Why did this project go silent, bro?
What problems did you run into
:cry:
 
I'll post some updates later this month. I'm still in the early stages of development, currently coding the battle system. Progress has been a bit slow just due to time constraints and being a solo dev right now. If I can bring more people on board, things should move a lot faster.
 
List out the systems you're missing, and I'll reverse-engineer the rest for you.
 
Just joined this forum, found this post.
I'm working on rebuild the whole system for Mac version and coding with Claude code in Rust

Not focus on login/create char system yet.
 

Attachments

  • PixPin_2026-07-15_20-05-57 - Janus Emulator - RaGEZONE Forums
    PixPin_2026-07-15_20-05-57.webp
    650.1 KB · Views: 29
Back