14. The Codex
14.1 Design Philosophy
The Codex is the game’s cultural literacy layer. Malacca operates in a world where every title, faction, weapon, and custom carries weight the player may not arrive with. The Codex does not interrupt the game to explain — it waits. Players who want context can seek it. Players who prefer to move through the world on instinct are never forced to stop.
The Codex is non-diegetic but tonally grounded. It is not presented as a UI menu. It reads as a document the Mata-mata network would actually maintain — a field intelligence archive, written in the voice of someone who expects the reader to be smart and already inside the world.
Every Codex term that appears in the game’s world — spoken in dialogue, written on a sign, embossed on a guard’s insignia — is a wikiword. The player can pause on it and enter its entry. Reading an entry surfaces further wikiwords, allowing the player to move laterally through connected knowledge. The back button returns them to exactly where they were.
Design Principle — The Codex Does Not Hold Hands
Entries are written for someone who has already encountered the thing being described. They deepen rather than explain. A player who reads the Bendahara entry should feel like they understand a layer of the sultanate they were already sensing — not like they received a history lecture.
14.2 Navigation Model
Wikiword linking — any term in the game world that has a Codex entry is visually marked when the player focuses on it. In dialogue, subtitles underline the term. In the environment, interactable surfaces (seals, banners, written notices) offer a prompt. Selecting any marked term opens its entry without leaving the current scene — the entry renders as an overlay.
History stack — the player maintains a navigation stack. Every entry opened is added. The back prompt steps through the stack in reverse. There is no depth limit. Closing the Codex entirely clears the stack.
Tree browser — accessible from the Codex root screen, presenting all eight categories as expandable branches. Players can browse by category when not currently reading an entry. The tree shows which entries have been discovered (unlocked) versus which exist but haven’t been encountered yet (greyed, title visible, content locked until the term is encountered in the world).
Design Note — Discovery Gating
Entries are not unlocked by the player purchasing or finding them. They unlock automatically the first time the relevant term is encountered in the world — heard in dialogue, read in the environment, or introduced by a mission briefing. A player who completes the game without entering the Tamil Quarter will not have unlocked Tamil Shahbandar entries. The Codex reflects what the protagonist has been exposed to, not what the player has researched.
14.3 Category Tree
The Codex is organised across eight top-level categories. Each contains a structured set of entries. Categories are not mutually exclusive — a wikiword in the People category may link to entries in Factions, Titles & Offices, and Timeline.
Timeline
A chronological index of significant events from the founding of the Malacca Sultanate through the Portuguese conquest of 1511. The protagonist exists inside this timeline — reading it is reading the frame around everything they are doing. Entries are anchored to specific years and include cross-links to relevant People, Places, and Factions entries.
Scope: Parameswara’s founding, the conversion to Islam, the peak of the port under Tun Perak, the succession crises, the trial of Hang Tuah, the approach of the Portuguese fleet, the fall.
People
Named individuals — historical figures, recurring NPCs, and key antagonists. Entries cover who the person is, what office they hold, what they want, and what the protagonist’s relationship to them is. Historical figures include notes on their documented historical role versus their function in the game’s narrative.
Scope: Hang Tuah, Hang Jebat, Hang Kasturi, Hang Lekir, Hang Lekiu, Tun Perak, Albuquerque, the Batin of the Orang Laut, the protagonist’s parents, the disappeared empu. Supporting NPCs added as they are named in mission design.
Places
Geographic zones, named buildings, anchorages, and regions within and beyond Malacca. Entries include the zone’s function in the world, its political ownership, its historical significance, and its gameplay role. The Hinterland shrines, the Gedung warehouses, the Istana compound, and each Shahbandar quarter each have their own entry.
Scope: All zones defined in Section 2.2, plus cross-river geography, the Portuguese fleet’s approach route, and key historical trade partner ports referenced in NPC dialogue.
Weapons & Ilmu
Physical weapons carried or encountered in the game, and the three Ilmu traditions the protagonist can develop. Weapon entries cover construction, cultural context, and combat role. Ilmu entries cover the philosophical and spiritual tradition the path draws from, not just its mechanical expression.
Scope: Kerambit, Keris (with sub-entries per trait), Sumpitan and its dart types, the short weapons of the enemy roster. Ilmu Langkah, Ilmu Kebal, Ilmu Pukau as traditions — their roots in Malay martial knowledge and their relationship to Semangat.
Factions
The major power structures the protagonist moves between, under, and against. Entries cover the faction’s purpose, its internal hierarchy, its relationship to the Sultanate, its current state in the game’s timeline, and how the protagonist interfaces with it.
Scope: The Mata-mata intelligence network, the five Shahbandar offices by quarter (Malay, Javanese, Gujarati, Tamil, Chinese), the Orang Laut, the Sultanate and Istana household, the Portuguese Estado da India.
Titles & Offices
Institutional terms, not personal names. The ranks, roles, and honorifics that structure Malaccan society. This is the cultural glossary the entire enemy roster is built on — a player who understands what a Temenggung controls versus what a Shahbandar controls understands the political geography of every mission.
Scope: Bendahara, Temenggung, Shahbandar, Laksamana, Hulubalang, Pendekar, Batin, Nakhoda, Ketua, Pengawal, Mata-mata, Laskar. All guard titles in Section 8.5 have corresponding entries here.
Culture & Belief
The spiritual, social, and customary layer of the world. Semangat as a concept predating its mechanical expression. Amok as a documented historical and cultural phenomenon, not just a game state. The Keris as a living object in Malay tradition, not a weapon. Peranakan identity, Baba and Nyonya distinctions, Islamic practice in the port, the animist traditions the Orang Laut carry.
This is the category that most directly serves the game’s cultural argument. Done well, a player who reads these entries understands why Malacca matters in a way that no mission briefing can deliver.
Scope: Semangat, Amok, the Keris mythos, Ilmu as a concept, Peranakan origins and identity, the five Shahbandar communities’ cultural practices, the Orang Laut’s spiritual relationship to the sea, Islamic jurisprudence in the port, the Warangan ritual tradition.
Trade & Commerce
The economic and mercantile layer of the world’s busiest port. Trade goods, their origins, and their significance. The mechanics of the Shahbandar system — how duties, anchorage rights, and protection arrangements actually worked. The currencies in circulation. The information networks that ran alongside the trade routes.
This category is lighter than the others but earns its place. The protagonist’s merchant background, the Shahbandar faction economy, and the corrupt trade arrangements that accelerate Malacca’s fall all sit on a foundation the player should be able to access.
Scope: Major trade commodities (spices, tin, textiles, porcelain), the anchorage and duty system, the role of the Bendahara in regulating trade, the Chinese and Gujarati merchant communities’ economic structures, the intelligence value of trade manifests.
14.4 Entry Format — Canonical Template
All Codex entries follow a consistent format. Writers assigned to Codex production must adhere to this template. Variation in depth is acceptable; variation in structure is not.
[TERM] — [CATEGORY]
[One-sentence definition. Precise. No scene-setting.]
[Body — 2 to 4 paragraphs. Historical or cultural context first.
Game-relevant context second. Wikiwords marked in-text.]
[If applicable: RELATED ENTRIES — comma-separated list of linked terms]
Voice: field intelligence archive. Knowledgeable, economical, without condescension. The entry assumes the reader has already encountered the term in the world. It does not repeat what the player already knows from gameplay — it deepens it.
Production Note — Codex Content Assignment
Full Codex content production is a dedicated writer assignment and does not belong in the GDD. Entry count estimate: 80–120 entries across all eight categories. Priority order for first draft: Titles & Offices (required to support existing enemy design), People (required to support narrative), Timeline (required to contextualise Act structure). See Appendix A for the entry register.