Angels Online — work-in-progress server + protocol documentation

Newbie Spellweaver
Joined
Nov 17, 2023
Messages
45
Reaction score
38
Angels Online (IGG) shut down in February 2026. I've spent the last while reverse engineering the client and reconstructing its network protocol. There's a local server that runs, but it's early — a lot of it is still broken.

What works so far

Login, character creation, the tutorial, picking a class, inventory with equip/unequip and durability, stats computed from the client's item data, shops, map changes, basic combat with damage and loot, and NPC dialogue. The Angel Lyceum is populated with 52 NPCs, 81 monsters and 158 resources in their real positions.

What doesn't

NPCs don't move or react, monsters don't respawn, dialogue options close the box instead of continuing, boxes can't be opened, floor portals do nothing, there's no EXP or levelling, and passwords aren't validated — the auth block isn't decrypted yet. There are screenshots of each one in the README.

The documentation is the real part

Framing, the evolving cipher, message formats, and how every finding was verified — including the ones I got wrong and how they were caught. That's the bit I'd point at first, even if the server never gets finished.



If you want to jump in

Pull requests are welcome. Anything you feel like working on — the docs are detailed enough to pick something up without me explaining it.

If you still have access to a working AO server, traffic captures help a lot. Most of what's missing is missing because it was never recorded. The repo has a proxy that logs both directions with timestamps, and the specific gaps are listed in the README.

Fair warning

I'm one person doing this in my free time, with AI assistance for a good part of it, and both my hours and that assistance run out. Progress comes in bursts and then goes quiet for a while, so I'd rather not set expectations I can't meet. If something's broken and you know how to fix it, go ahead — that'll move faster than waiting on me.

Corrections are very welcome too — there was work done on AO before me that saved me weeks, and people have already pointed out things I'd missed.
This whole thing started from this thread: https://forum.ragezone.com/threads/request-angels-online-server-files.1258617/

Thanks and Take a Kuru ~

Edit:
New Link to Client Use ->
Patch if have old client : -> this only have paks, Launcher start.exe edit and other settings archive.
 

Attachments

  • 1165267329999982612 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums
    1165267329999982612.webp
    13.5 KB · Views: 11
Last edited:
for now i have problems with skills and fighting system
1790053190960 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Visual Effect and skill sound not work but some buff can work
- Other problem is cast injury cure from sword but no heal hp - Update: this is partly solved, skills works and heal but sprites with visual efects not. need optimize animations atk on mobs.

1790053295208 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Combat system works partly can "skills" enemies and basic attacks works but animation is too bad :P

1790053413360 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums
1790053432013 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums

- Can't sell items but can buy 1 to 1 not multiply items :P - Update: this is solved.

Well and a lot of problems :P ~

i try capture packets from others places and repair slowly.

it's hard but i trying ~
 
Last edited:
Update:
Breeze set NPC only Cupid and Breeze Wood Angels works , others npc only set but without dialog.
1790136199953 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Angels tutor works only quit training option - still in progress dialogs when set your faction because return to graduation palace.
1790136280367 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums

- Graduation Palace: only works breeze zone for now, i resolve others later.
1790136331505 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums
1790136352289 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums

1790136372002 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Dense forest and cryptic works and populated with mobs, npc still in progress not have dialogs
1790136542914 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums

1790136582312 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


1790136596603 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Thats for now , i repopulated mobs in maps , if any wanna help with quest or dialogs or solve problem with skills can use my repo for that :D ~ any help are welcome ~
 
Last edited:
update: Heart of eden populated
1790203028429 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums

1790203036124 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums

- Some maps are populated

1790203044097 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


1790203150475 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Atlantis populated without instances. not have data from thats places for obtain enemies positions and bosses.

1790203328941 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- 4 factions are works to selected in graduation palace.
That for now.
i populated maps when i can :D ~

pd: client link
 
Last edited:
poblated is populated??
Yeah, my bad — I meant populated

- Update: Floating populated except instance.

1790207376806 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


Update: Forest, Desert and Candyland Populated.
1790224780570 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums

1790224803962 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums

1790224814717 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Super wings works in worked maps.
 
Last edited:
Map update: Populated more maps SIlverSnow Realm
1790306983680 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Space Cowboy
1790307133161 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Sakura Festival
1790307195000 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Sequoia
1790307241942 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- BearScape
1790307449504 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Others Maps Populated:
- Jurassic
- Pharaoh
- East Orient
- Magma Flux

- Super Wings Works in thats maps.

Thats All for now.
 
Update: Dungeon Populated
1790383063156 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Next Maps are populated based on ALO TW captured packets. They are not 100% populated in terms of mob quantity, but a large portion of the mobs are present. Instances are not populated.
- Sun Sea Maze
1790383209076 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Cybertronica
1790383246054 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Night City Code - Last map From Igg until ded
1790383327285 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- These 3 maps are the only ones that can currently be extracted from ALO TW packets. ALO has one additional new map, but for now, only these 3 maps are available.
- Return to populated i try populated shuwa but my tokens are dead for today , later continue.
1790383448113 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


:P ~ if any can repair skills system and optimize combat system are very welcome. Repository is in first post :D ~

- Map update: All maps are populated Except Shuwa and instances ~

- Astralfield
1790400554435 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums



- Warring
1790400607205 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Celestia
1790400635091 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Abysston
1790400673709 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums



- Now i check maps and try to works more in combat system and skill system.

All are up in my repo ~
 
Last edited:
- Little update: Skill system works but i need test more time and set skills vendors in populated maps.
1790482881053 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums
 
Update: Skills feature is functional but still needs some polish. For now, you can buy skills from Lyceum to Atlantis.

1790570827210 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


1790571000741 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


1790571025914 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


1790571118460 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


Later update others skills not have more tokens for today xD
 
Mini update: You can now buy skills up to Pharaoh.

1790616962928 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums


- Also, there is a flag active that makes everything in the shop cost only 1 Gold per item. The price you see displayed is just a client-side visual, but when you buy it, you will only pay 1 Gold.

COMPRAS_1_DE_ORO = True, if set false prices return to normal. this found in configuracion.py.

1790617521719 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums
1790617530882 - Angels Online — work-in-progress server + protocol documentation - RaGEZONE Forums
 
Last edited:
i capture from others P. Servers and from Angels Love Online From TW .
 
Back