Codex Item - Machine Readable Reference

The Codex is a readable item (book) in Remixed Dungeon that displays story text when read.

• Codex.java - Main Codex class extending Book

• Extends: Book (com.nyrds.pixeldungeon.items.books.Book)
• Package: com.watabou.pixeldungeon.items

• stackable: false (cannot stack)
• image: 4 (sprite index)
• codexId: int, default -1 (determines which story to display)
• text: String (custom text, can be null or “Unknown”)

• doRead(Char hero): Displays story text via WndStory.showCustomStory()
• fromJson(JSONObject itemDesc): Loads codex text from JSON configuration
• price(): Returns 5 * quantity()
• getCodexId(): Returns codex ID, randomizes if < 0, clamps to max

This entity is primarily implemented in Java. JSON configuration may include:

• “text”: Story text content (processed through StringsManager.maybeId())

<string name="Codex_Blinded">You can't read while blinded</string>
<string-array name="Codex_Story">
  <!-- Array of story texts -->
</string-array>

This entity is implemented in Java, no Lua script exists

• When read, displays custom text if set, otherwise displays story from Codex_Story array
• Uses StringsManager.getVars() to access story array
• Random story selection if codexId is not set
• Cannot be upgraded or identified beyond normal item behavior

• Found as loot in dungeon
• Provides lore/story content to player
• Part of the books item category