Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
b8667e6
Add ROla field maps; update Field.pm and servers
boscv Feb 26, 2026
9d21c43
Merge branch 'OpenKore:master' into master
boscv Mar 2, 2026
3842c8a
Merge branch 'OpenKore:master' into master
boscv Mar 6, 2026
f099bd7
Merge branch 'OpenKore:master' into master
boscv Mar 9, 2026
1103dcd
Add OpenKore LLM curation planning documents
boscv Mar 10, 2026
003431d
Create focused OpenKore core knowledge bundle
boscv Mar 10, 2026
ce1d42b
Refine src-only core knowledge bundle and subsystem docs
boscv Mar 10, 2026
9c15fad
Curate plugin and configuration knowledge bundle
boscv Mar 10, 2026
18e5be6
Curate gameplay tables and networking knowledge bundle
boscv Mar 10, 2026
8cf0985
Add deep system architecture map for knowledge base
boscv Mar 10, 2026
37e3b05
Add core module dependency map for knowledge bundle
boscv Mar 10, 2026
81087b9
Add OpenKore debugging playbook knowledge guide
boscv Mar 10, 2026
f34ff98
Add practical OpenKore development recipes
boscv Mar 10, 2026
6863615
Add OpenKore developer FAQ dataset
boscv Mar 10, 2026
ffb619e
Add numbered architecture knowledge layer docs
boscv Mar 10, 2026
b6282b0
Add runtime flow docs with Mermaid architecture diagrams
boscv Mar 10, 2026
e8b1f4b
Add debugging playbook, decision trees, and pitfalls docs
boscv Mar 10, 2026
641c5d1
Add practical development, FAQ, and onboarding knowledge docs
boscv Mar 10, 2026
3afda82
Merge pull request #2 from boscv/codex/build-architecture-documentati…
boscv Mar 10, 2026
6e28be9
Normalize knowledge docs to numbered-only set
boscv Mar 10, 2026
5101bc3
Merge branch 'codex/document-curation-plan-for-openkore' into codex/b…
boscv Mar 10, 2026
82279a3
Merge pull request #3 from boscv/codex/build-architecture-documentati…
boscv Mar 10, 2026
5929b6f
Create GPT upload final merged knowledge bundle
boscv Mar 10, 2026
70fc5df
Merge pull request #4 from boscv/codex/build-architecture-documentati…
boscv Mar 10, 2026
e18dff0
update 1
boscv Mar 11, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
Binary file added fields/ROla/1@def03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/1@gl_k.fld2.gz
Binary file not shown.
Binary file added fields/ROla/1@glast.fld2.gz
Binary file not shown.
Binary file added fields/ROla/1@jtb.fld2.gz
Binary file not shown.
Binary file added fields/ROla/1@ma_b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/1@ma_c.fld2.gz
Binary file not shown.
Binary file added fields/ROla/1@pump.fld2.gz
Binary file not shown.
Binary file added fields/ROla/1@vrsn.fld2.gz
Binary file not shown.
Binary file added fields/ROla/2@gl_k.fld2.gz
Binary file not shown.
Binary file added fields/ROla/2@pump.fld2.gz
Binary file not shown.
Binary file added fields/ROla/abbey03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/abbey03a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/abbey03b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/abyss_01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/abyss_02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/abyss_03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/abyss_03a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/abyss_03b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/alberta.fld2.gz
Binary file not shown.
Binary file added fields/ROla/alde_dun03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/alde_dun04.fld2.gz
Binary file not shown.
Binary file added fields/ROla/alde_gld.fld2.gz
Binary file not shown.
Binary file added fields/ROla/alde_tt03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/aldeg_cas01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/aldeg_cas02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/aldeg_cas03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/aldeg_cas04.fld2.gz
Binary file not shown.
Binary file added fields/ROla/aldeg_cas05.fld2.gz
Binary file not shown.
Binary file added fields/ROla/aru_gld.fld2.gz
Binary file not shown.
Binary file added fields/ROla/arug_cas02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ba_bath.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ba_lib.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ba_pw01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ba_pw02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/bat_a01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/beach_dun2.fld2.gz
Binary file not shown.
Binary file added fields/ROla/bif_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/bif_fild02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/bra_dun01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/bra_dun02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/bra_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/bra_in01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/brasilis.fld2.gz
Binary file not shown.
Binary file added fields/ROla/cmd_fild02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/cmd_fild03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/cmd_fild04.fld2.gz
Binary file not shown.
Binary file added fields/ROla/cmd_fild05.fld2.gz
Binary file not shown.
Binary file added fields/ROla/cmd_fild06.fld2.gz
Binary file not shown.
Binary file added fields/ROla/cmd_fild07.fld2.gz
Binary file not shown.
Binary file added fields/ROla/cmd_fild08.fld2.gz
Binary file not shown.
Binary file added fields/ROla/com_d02_i.fld2.gz
Binary file not shown.
Binary file added fields/ROla/comodo.fld2.gz
Binary file not shown.
Binary file added fields/ROla/dic_dun01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/dic_dun02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/dic_dun02a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/dic_dun02b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/dic_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/dic_fild02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/dic_in01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/dicastes01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/dicastes02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ein_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ein_fild04.fld2.gz
Binary file not shown.
Binary file added fields/ROla/force_map1.fld2.gz
Binary file not shown.
Binary file added fields/ROla/force_map2.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_f10_a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_f10_b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_f10_c.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_fild00.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_fild03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_fild05.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_fild06.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_fild07.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_fild09.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_fild10.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_fild10_a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_fild10_b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gef_fild10_c.fld2.gz
Binary file not shown.
Binary file added fields/ROla/geffen.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gefg_cas02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gefg_cas03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gefg_cas05.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gl_cas01_.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gl_dun01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gl_sew02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/glast_01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gld_dun02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gld_dun04.fld2.gz
Binary file not shown.
Binary file added fields/ROla/gon_dun01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/hu_fild03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ice_dun01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/itemmall.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_ac01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_ac01_a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_ac01_b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_ac01_c.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_ac01_d.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_ac02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_ac02_a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_ac02_b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_ac02_c.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_ac02_d.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_int.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_int01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_int02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_int03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/iz_int04.fld2.gz
Binary file not shown.
Binary file added fields/ROla/izlude.fld2.gz
Binary file not shown.
Binary file added fields/ROla/izlude_a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/izlude_b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/izlude_c.fld2.gz
Binary file not shown.
Binary file added fields/ROla/izlude_d.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job3_arch01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job3_arch02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job3_gen01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job3_guil01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job3_guil02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job3_guil03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job3_rang01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job3_rang02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job3_rune01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job3_rune02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job3_sha01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job3_war01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job_hunte.fld2.gz
Binary file not shown.
Binary file added fields/ROla/job_hunter.fld2.gz
Binary file not shown.
Binary file added fields/ROla/jupe_core.fld2.gz
Binary file not shown.
Binary file added fields/ROla/juperos_01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/juperos_01a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/juperos_01b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/lasa_dun01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/lasa_dun02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/lasagna.fld2.gz
Binary file not shown.
Binary file added fields/ROla/lhz_dun03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/lhz_dun_n.fld2.gz
Binary file not shown.
Binary file added fields/ROla/lou_dun01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/lou_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/lou_fild01a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/lou_fild01b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mag_dun01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mag_dun01a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mag_dun01b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mag_dun02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mag_dun02a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mag_dun02b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/malangdo.fld2.gz
Binary file not shown.
Binary file added fields/ROla/man_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/manuk.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mid_camp.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mjolnir_01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mjolnir_02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mjolnir_07.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mjolnir_07a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mjolnir_07b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/moc_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/moc_fild10.fld2.gz
Binary file not shown.
Binary file added fields/ROla/moc_fild12.fld2.gz
Binary file not shown.
Binary file added fields/ROla/moc_fild20.fld2.gz
Binary file not shown.
Binary file added fields/ROla/moc_fild22.fld2.gz
Binary file not shown.
Binary file added fields/ROla/moc_para0a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/moc_para0b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/moc_para0c.fld2.gz
Binary file not shown.
Binary file added fields/ROla/moc_pryd02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/moc_pryd04.fld2.gz
Binary file not shown.
Binary file added fields/ROla/morocc.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mosk_dun03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/mosk_fild02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/new_zone03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/nyd_dun01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/nyd_dun02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/odin_tem02a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/odin_tem02b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/odin_tem03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/orcsdun01_a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/orcsdun01_b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/orcsdun01_c.fld2.gz
Binary file not shown.
Binary file added fields/ROla/pay_dun00_a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/pay_dun00_b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/pay_dun00_c.fld2.gz
Binary file not shown.
Binary file added fields/ROla/pay_fild04.fld2.gz
Binary file not shown.
Binary file added fields/ROla/pay_mk.fld2.gz
Binary file not shown.
Binary file added fields/ROla/payg_cas01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/payg_cas02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/payg_cas03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/poring_c02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_castle.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_fild00.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_fild02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_fild04.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_fild05.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_fild06.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_fild08.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_fild08a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_fild08b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_fild08c.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_fild08d.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_fild09.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_maze02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_mk.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_mk_a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_mz03_i.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_sewb1.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_sewb2.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prt_sewb4.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prtg_cas01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prtg_cas02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/prtg_cas05.fld2.gz
Binary file not shown.
Binary file added fields/ROla/pvp_y_1-2.fld2.gz
Binary file not shown.
Binary file added fields/ROla/pvp_y_2-2.fld2.gz
Binary file not shown.
Binary file added fields/ROla/pvp_y_3-2.fld2.gz
Binary file not shown.
Binary file added fields/ROla/pvp_y_4-2.fld2.gz
Binary file not shown.
Binary file added fields/ROla/pvp_y_5-2.fld2.gz
Binary file not shown.
Binary file added fields/ROla/pvp_y_6-2.fld2.gz
Binary file not shown.
Binary file added fields/ROla/pvp_y_7-2.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ra_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ra_fild03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ra_fild05.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ra_fild12.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ra_fild12a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ra_fild12b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ra_san01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ra_san01a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ra_san01b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ra_san05.fld2.gz
Binary file not shown.
Binary file added fields/ROla/rachel.fld2.gz
Binary file not shown.
Binary file added fields/ROla/rgsr_in.fld2.gz
Binary file not shown.
Binary file added fields/ROla/rwc01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/schg_cas01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/sec_in02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/sec_pri.fld2.gz
Binary file not shown.
Binary file added fields/ROla/spl_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/spl_fild02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/spl_fild03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/te_aldecas2.fld2.gz
Binary file not shown.
Binary file added fields/ROla/te_aldecas3.fld2.gz
Binary file not shown.
Binary file added fields/ROla/te_aldecas4.fld2.gz
Binary file not shown.
Binary file added fields/ROla/te_aldecas5.fld2.gz
Binary file not shown.
Binary file added fields/ROla/te_prtcas02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/te_prtcas05.fld2.gz
Binary file not shown.
Binary file added fields/ROla/teg_dun02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/thor_v01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/thor_v03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/thor_v03a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/thor_v03b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/tur_dun01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/um_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/um_fild03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ve_fild01.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ve_fild02.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ve_fild03.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ve_fild03a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ve_fild03b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ve_fild05.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ve_fild07.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ve_fild07a.fld2.gz
Binary file not shown.
Binary file added fields/ROla/ve_fild07b.fld2.gz
Binary file not shown.
Binary file added fields/ROla/yuno_fild12.fld2.gz
Binary file not shown.
237 changes: 237 additions & 0 deletions gpt_upload_final/architecture.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,237 @@
# OpenKore LLM Context
---

## Objective
This layer gives an LLM enough structural context to reason about OpenKore runtime behavior, module boundaries, and extension points.

## Runtime model (high level)
1. `src/functions.pl` boots runtime services, loads config/tables, initializes network mode, and drives the main loop.
2. Network receive handlers (`src/Network/Receive*.pm`) transform packets into world-state updates.
3. Actor state (`src/Actor.pm`, `src/ActorList.pm`) becomes the shared world model for decision logic.
4. AI (`src/AI.pm`, `src/AI/CoreLogic.pm`) evaluates state and schedules actions through tasks.
5. Task execution (`src/TaskManager.pm`, `src/Task/*.pm`) performs multi-step actions and emits packets through send modules (`src/Network/Send*.pm`).
6. Plugins (`src/Plugins.pm`, `plugins/*`) and macro layers (`plugins/macro`, `plugins/eventMacro`) inject automation and custom behavior.

## Key architecture anchors
- **Entry/control loop**: `src/functions.pl`
- **Global state/config loading**: `src/Globals.pm`, `src/Settings.pm`, `src/FileParsers.pm`, `control/`
- **AI + behavior**: `src/AI.pm`, `src/AI/CoreLogic.pm`
- **Actor model**: `src/Actor.pm`, `src/ActorList.pm`, `src/Actor/*`
- **Task orchestration**: `src/Task.pm`, `src/TaskManager.pm`, `src/Task/*`
- **Networking and packets**: `src/Network.pm`, `src/Network/*`
- **Plugin/macro automation**: `src/Plugins.pm`, `plugins/macro/*`, `plugins/eventMacro/*`

# OpenKore Architecture Overview
---

## Top-level structure
- `src/`: core runtime modules (AI, actor model, networking, tasks, plugins API, command layer).
- `control/`: operator configuration and behavior policies (`config.txt`, control lists, route/macro inputs).
- `tables/`: protocol/game data mappings (packet maps, item/skill/map metadata, server-specific variants).
- `plugins/`: optional extensions, including macro/eventMacro automation stacks.
- `fields/`: map field data used by routing/navigation.

## Core runtime layers
1. **Bootstrap + loop**: `src/functions.pl` and `src/Modules.pm`
2. **State + config**: `src/Globals.pm`, `src/Settings.pm`, `src/FileParsers.pm`
3. **Network transport + packet translation**: `src/Network.pm`, `src/Network/{Receive,Send,PacketParser}.pm`
4. **World model**: `src/Actor.pm`, `src/ActorList.pm`, `src/Field.pm`
5. **Decision engine**: `src/AI.pm`, `src/AI/CoreLogic.pm`
6. **Execution engine**: `src/TaskManager.pm`, `src/Task/*.pm`
7. **Extension surface**: `src/Plugins.pm`, `src/Commands.pm`, `plugins/*`

## Architectural characteristics
- **Event-driven and loop-based**: runtime state is advanced each tick by receive updates + AI/task progression.
- **Protocol-adapter design**: packet send/receive classes are split by server type under `src/Network/Receive/*` and `src/Network/Send/*`.
- **Policy outside code**: behavior is heavily configured via `control/` and `tables/` files.
- **Extension-first automation**: macro/eventMacro run as plugins and reuse command/hook/task pathways.

# System Architecture Map (Textual)
---

## Primary flow
`functions.pl main loop` -> `Network receive` -> `Actor/Globals update` -> `AI decision` -> `Task execution` -> `Network send`

## Subsystem map

### 1) Networking
- Connection/mode handling: `src/Network.pm`, `src/Network/DirectConnection.pm`, `src/Network/XKore*.pm`
- Packet ingestion and dispatch: `src/Network/MessageTokenizer.pm`, `src/Network/PacketParser.pm`, `src/Network/Receive.pm`, `src/Network/Receive/*`
- Packet construction: `src/Network/Send.pm`, `src/Network/Send/*`

### 2) Actor system
- Base entity model: `src/Actor.pm`, `src/Actor/*`
- Actor collections and lookup: `src/ActorList.pm`
- World/map coupling: `src/Field.pm`, map and position state in globals

### 3) AI subsystem
- AI stack state and sequencing: `src/AI.pm`
- Core behavior logic: `src/AI/CoreLogic.pm`
- Uses actor/world/config state; issues actions via task manager and commands

### 4) Task subsystem
- Task abstraction: `src/Task.pm`
- Scheduler and lifecycle: `src/TaskManager.pm`
- High-impact tasks: `src/Task/Route.pm`, `src/Task/Move.pm`, `src/Task/TalkNPC.pm`, `src/Task/UseSkill.pm`

### 5) Configuration subsystem
- Config discovery/loading: `src/Settings.pm`, `src/FileParsers.pm`
- Runtime shared state: `src/Globals.pm`
- Policy sources: `control/*`, `tables/*`

### 6) Plugin + macro subsystem
- Hook and plugin lifecycle: `src/Plugins.pm`
- Command bridge: `src/Commands.pm`
- Macro engines: `plugins/macro/*`, `plugins/eventMacro/*`

## Key entry points
- Startup/main loop: `src/functions.pl`
- Command dispatch: `src/Commands.pm`
- Hook registration: `src/Plugins.pm`
- AI tick path: `src/AI.pm` -> `src/AI/CoreLogic.pm`
- Packet receive path: `src/Network/Receive.pm` + server-specific receivers

# Core Subsystems
---

## AI
- Main modules: `src/AI.pm`, `src/AI/CoreLogic.pm`
- Role: maintain AI queues/state machines, evaluate combat/loot/movement priorities, enqueue tasks.
- Inputs: actor state, config policies, packet-driven updates.
- Outputs: task requests, command invocations, action intents.

## Actor system
- Main modules: `src/Actor.pm`, `src/ActorList.pm`, `src/Actor/*`
- Role: represent player/NPC/monster/portal entities, with indexed lookup for targeting and proximity logic.
- Inputs: receive handlers and map updates.
- Outputs: query surface for AI, tasks, commands, and plugins.

## Networking
- Main modules: `src/Network.pm`, `src/Network/{Receive,Send,PacketParser,MessageTokenizer}.pm`, `src/Network/XKore*.pm`
- Role: manage transport mode, parse inbound packets, encode outbound actions, support server-specific packet families.
- Inputs: socket data + outgoing action intents.
- Outputs: state mutations via receive handlers and serialized packets to servers/clients.

## Task system
- Main modules: `src/Task.pm`, `src/TaskManager.pm`, `src/Task/*`
- Role: run asynchronous multi-step actions (route, move, NPC dialogs, skill/item use).
- Inputs: AI/command/plugin action requests.
- Outputs: packet sends, follow-up tasks, completion/failure states consumed by AI.

## Plugin system
- Main modules: `src/Plugins.pm`, `plugins/*`
- Role: dynamic extension lifecycle (`register`, hooks, unload), runtime behavior injection.
- Inputs: startup/load events, packet-related hooks, periodic loop hooks.
- Outputs: custom commands, state transitions, automation triggers.

## Configuration system
- Main modules: `src/Settings.pm`, `src/FileParsers.pm`, `control/*`, `tables/*`
- Role: load policy and data files that parameterize AI, networking, and gameplay handling.
- Inputs: text configs and table files.
- Outputs: normalized runtime config/state in globals and subsystem-specific structures.

## Macro system
- Main modules: `plugins/macro/macro.pl`, `plugins/macro/Macro/*`, `plugins/eventMacro/eventMacro.pl`, `plugins/eventMacro/eventMacro/*`
- Role: declarative automation over hooks and game events, with conditional triggers and scripted actions.
- Inputs: macro definitions and live runtime events.
- Outputs: command execution and indirect task/network activity.

## Routing
- Main modules: `src/Task/Route.pm`, `src/Task/Move.pm`, `src/Field.pm`, `fields/*`
- Role: compute and execute navigation paths across map cells/portals.
- Inputs: destination intents, field data, actor position/state.
- Outputs: stepwise movement actions and route completion/fallback states.

# Module Dependency Map
---

## Dependency chains (high impact)
1. `src/functions.pl` -> `src/Settings.pm` / `src/FileParsers.pm` / `src/Modules.pm` (bootstrap)
2. `src/functions.pl` -> `src/Network.pm` + `src/Network/*` (connection and packet loop)
3. `src/Network/Receive*.pm` -> `src/Globals.pm` + `src/Actor*.pm` (state mutation)
4. `src/AI.pm` -> `src/AI/CoreLogic.pm` -> `src/TaskManager.pm` + `src/Task/*` (decision to execution)
5. `src/Task/*` -> `src/Network/Send*.pm` (action serialization)
6. `src/Plugins.pm` + `plugins/*` -> `src/Commands.pm` / AI / TaskManager (extension control paths)

## Subsystem dependency view
- **AI depends on**: Actor state, config policies, task scheduler, command surface.
- **Actor system depends on**: Network receive updates and global runtime registries.
- **Task system depends on**: AI/commands/plugins for intents; network send + actor/map updates for progression.
- **Plugin/macro depends on**: hook lifecycle (`src/Plugins.pm`), command execution (`src/Commands.pm`), global state.
- **Routing depends on**: task framework, field data (`fields/*`), movement packet sends.

## Coupling hotspots
- `src/Globals.pm`: shared mutable state touched by receive, AI, and plugins.
- `src/Commands.pm`: cross-cutting control surface used by user input and automation.
- `src/TaskManager.pm`: convergence point for AI and scripted automation.
- `src/Network/Receive.pm`: ingress bridge from protocol events to internal state transitions.

## Practical navigation order for analysis
1. Start at `src/functions.pl`.
2. Follow receive path (`src/Network/Receive.pm`, subtype receivers).
3. Inspect AI loop (`src/AI.pm`, `src/AI/CoreLogic.pm`).
4. Inspect task execution (`src/TaskManager.pm`, route/move/NPC tasks).
5. Inspect extension points (`src/Plugins.pm`, macro/eventMacro plugins).

# Code Index (Architecture-Oriented)
---

## Runtime entry and orchestration
- `src/functions.pl` — startup sequence and main loop
- `src/Modules.pm` — module loading registry
- `src/Globals.pm` — shared runtime state container

## AI
- `src/AI.pm` — AI framework and queue/state management
- `src/AI/CoreLogic.pm` — core decision routines

## Actor and world model
- `src/Actor.pm` — actor base model
- `src/ActorList.pm` — actor collections/indexing
- `src/Actor/*` — actor specializations
- `src/Field.pm` — map/field representation

## Task execution
- `src/Task.pm` — task abstraction
- `src/TaskManager.pm` — scheduler/executor
- `src/Task/Route.pm` — route planning/execution wrapper
- `src/Task/Move.pm` — movement task
- `src/Task/TalkNPC.pm` — NPC dialogue workflow
- `src/Task/UseSkill.pm` — skill-use workflows

## Networking and packets
- `src/Network.pm` — network facade and state
- `src/Network/DirectConnection.pm` — direct server mode
- `src/Network/XKore.pm`, `src/Network/XKore2.pm`, `src/Network/XKoreProxy.pm` — proxy/bridge modes
- `src/Network/MessageTokenizer.pm` — packet frame/token extraction
- `src/Network/PacketParser.pm` — packet definition parsing
- `src/Network/Receive.pm` + `src/Network/Receive/*` — inbound packet dispatch/handlers
- `src/Network/Send.pm` + `src/Network/Send/*` — outbound packet builders

## Commands, plugins, and automation
- `src/Commands.pm` — command parser/dispatcher
- `src/Plugins.pm` — plugin lifecycle and hook API
- `plugins/macro/macro.pl` + `plugins/macro/Macro/*` — legacy macro automation
- `plugins/eventMacro/eventMacro.pl` + `plugins/eventMacro/eventMacro/*` — event-driven macro automation

## Configuration and data sources
- `src/Settings.pm` — config path and file registration
- `src/FileParsers.pm` — config/table parsing
- `control/*` — user behavior policies and runtime options
- `tables/*` — server/data tables
- `fields/*` — map grids for routing/navigation

# Core Module Index
---

- `src/functions.pl` — bootstrap and main loop.
- `src/Modules.pm` — module registration/loading.
- `src/Globals.pm` — shared runtime state.
- `src/Settings.pm` — config path and file registration.
- `src/FileParsers.pm` — control/table parsing.
- `src/Commands.pm` — command parser and handlers.
- `src/AI.pm` and `src/AI/CoreLogic.pm` — AI orchestration and decisions.
- `src/Actor.pm` and `src/ActorList.pm` — entity model and indexing.
- `src/Task.pm` and `src/TaskManager.pm` — task abstraction and scheduling.
- `src/Task/Route.pm`, `src/Task/Move.pm`, `src/Task/TalkNPC.pm` — routing, movement, NPC flows.
- `src/Network.pm`, `src/Network/PacketParser.pm`, `src/Network/Receive.pm`, `src/Network/Send.pm` — network core.
Loading
Loading