#monster #battle #flags #game #mode #nes #rpg #damdara #dq #dragon-quest

bin+lib damdara

Dragon Quest Core Module, created in Rust

19 releases (7 breaking)

Uses new Rust 2024

new 0.8.1 Apr 29, 2025
0.7.0 Apr 27, 2025

#13 in Games

Download history 1581/week @ 2025-04-22

1,581 downloads per month

MIT license

3MB
4.5K SLoC

🏰 Damdara 🦀

Rust crate docs Forks Stars License

Damdara is a core logic crate for retro-fantasy that can be built in Rust,

fully recreating the “Fukkatsu no Jumon” system from the NES version of Dragon Quest,

while also having the ability to generate status by player name, equip items, and handle combat.

Table of Contents

Features

  • Generate resurrection "Fukkatsu no Jumon" from parameters (Parameters to Password)
  • Parameters generated from resurrection "Fukkatsu no Jumon" (Password to Parameters)
  • Calculate parameters enhanced by name
  • See list of monsters
  • Refer to any monster information
  • See parameter list
  • Refer to any parameter
  • See list of Item
  • Refer to any Item information
  • See list of Weapon
  • Refer to any Weapon information
  • See list of Armor
  • Refer to any Armor information
  • See list of Shield
  • Refer to any Shield information
  • Reproduction of battle scenes
  • See list of Town
  • Refer to any Town information
  • Refer to any World information
  • See list of Message
  • Explore the field
  • Explore the Town

This diagram shows the 120-bit structure of the “Fufutsu no Jumon”.

The name, experience value, gold, items, equipment, key items, flag information, etc. are packed and stored strictly in bits.

From this structure, the structure rearranged to generate the “Fufutsu no Jumon” is as follows.

Bit configuration mapping table for password generation.

Byte Index Field Description Bits (from MSB to LSB)
0 Checksum (CRC-8) [7:0]
1 Experience (lower 8 bits) [7:0]
2 Pattern[2] (1) + Necklace (1) + Name[2] (6) [7], [6], [5:0]
3 Item[3] + Item[2] [7:4], [3:0]
4 Gold (lower 8 bits) [7:0]
5 Name[0] (6) + Golem (1) + Pattern[1] (1) [7:2], [1], [0]
6 Item[7] + Item[6] [7:4], [3:0]
7 Pattern[0] + Dragon (1) + Name[3] (6) [7], [6], [5:0]
8 Weapon (3) + Armor (3) + Shield (2) [7:5], [4:2], [1:0]
9 Gold (upper 8 bits) [7:0]
10 Keys + Herbs [7:4], [3:0]
11 Item[5] + Item[4] [7:4], [3:0]
12 Experience (upper 8 bits) [7:0]
13 DragonScale (1) + Name[1] (6) + WarriorRing (1) [7], [6:1], [0]
14 Item[1] + Item[0] [7:4], [3:0]

Installation

Cargo

cargo install damdara

Add to project

cargo add damdara

Brew

brew tap webcyou-org/tap
brew install damdara

Usage

cargo run <input>

or

damdara <input>

If input is not present, the default brave value is returned.

cargo run

player name: ゆうてい
summary: PlayerSummary { name: "ゆうてい", level: 1, hp: 15, mp: 0, gold: 0, experience: 0 }
strength_status: StrengthStatus { level: 1, strength: 4, agility: 3, max_hp: 15, max_mp: 0, attack_power: 4, defense_power: 1, weapon: "なし", armor: "なし", shield: "なし" }
item: ["なし", "なし", "なし", "なし", "なし", "なし", "なし", "なし"]

The name can be specified by giving -n

cargo run -- -n だい

player name: た゛い
summary: PlayerSummary { name: "た゛い\u{3000}", level: 1, hp: 14, mp: 0, gold: 0, experience: 0 }
strength_status: StrengthStatus { level: 1, strength: 4, agility: 4, max_hp: 14, max_mp: 0, attack_power: 4, defense_power: 2, weapon: "なし", armor: "なし", shield: "なし" }

By granting options, you can change parameters, possess items, change equipment, and do many other things.

If you want to give 200 experience. The level is automatically reflected.

cargo run -- -n だい -e 200

player name: た゛い
summary: PlayerSummary { name: "た゛い\u{3000}", level: 5, hp: 32, mp: 20, gold: 0, experience: 200 }
strength_status: StrengthStatus { level: 5, strength: 11, agility: 10, max_hp: 32, max_mp: 20, attack_power: 11, defense_power: 5, weapon: "なし", armor: "なし", shield: "なし" }

Furthermore, if you wish to grant 300 Gold.

cargo run -- -n だい -e 200 -g 300

player name: た゛い
summary: PlayerSummary { name: "た゛い\u{3000}", level: 5, hp: 32, mp: 20, gold: 300, experience: 200 }
strength_status: StrengthStatus { level: 5, strength: 11, agility: 10, max_hp: 32, max_mp: 20, attack_power: 11, defense_power: 5, weapon: "なし", armor: "なし", shield: "なし" }

If you want to change the item possession, pass the corresponding item IDs separated by commas.

cargo run -- -n だい -i 2,3,4

player name: た゛い
summary: PlayerSummary { name: "た゛い\u{3000}", level: 1, hp: 14, mp: 0, gold: 0, experience: 0 }
strength_status: StrengthStatus { level: 1, strength: 4, agility: 4, max_hp: 14, max_mp: 0, attack_power: 4, defense_power: 2, weapon: "なし", armor: "なし", shield: "なし" }
item: ["せいすい", "キメラのつばさ", "りゅうのうろこ", "なし", "なし", "なし", "なし", "なし"]

It is also possible to put on any equipment by specifying ID.

cargo run -- -n だい -w 3 -a 5 -s 3

summary: PlayerSummary { name: "た゛い\u{3000}", level: 1, hp: 14, mp: 0, gold: 0, experience: 0 }
strength_status: StrengthStatus { level: 1, strength: 4, agility: 4, max_hp: 14, max_mp: 0, attack_power: 14, defense_power: 46, weapon: "どうのつるぎ", armor: "はがねのよろい", shield: "みかがみのたて" }
item: ["なし", "なし", "なし", "なし", "なし", "なし", "なし", "なし"]

flags are a group of flags that indicate whether a player has equipped a particular item or defeated a boss monster.

They can be specified collectively as a 5-digit bit string with the command line argument --flags.

cargo run -- -n だい --flags 01010

List of CLI options

option type default value Description
-n, --name String "ゆうてい" Main character's name
-e, --exp u16 0 XP
-g, --gold u16 0 Gold in possession
-w, --weapon u8 0 The number of the weapon you are equipped with
-a, --armor u8 0 The number of the armor you are equipped with
-s, --shield u8 0 The number of the shield you are equipped with
-i, --item Vec(comma delimited) not in possession List of item numbers
-y, --herbs u8 0 Number of herbs held
-k, --keys u8 0 Number of keys held
--flags Flags structure All false status flag
-p, --password String Maximum Strengthened Password Fukkatsu no Jumon

Flags option details(--flags)

digit position bit Field Name Description
1st digit 0/1 has_dragon_scale Equipped with the scales of a dragon?
2st digit 0/1 has_warrior_ring Are you equipped with a warrior's ring?
3st digit 0/1 has_cursed_necklace Did you get the beak necklace?
4st digit 0/1 defeated_dragon You slayed the dragon.
5st digit 0/1 defeated_golem You beat the golem.
  • Specify with 5 digits 0/1 like --flags 01000.
  • If not specified, default 00000 (all false)

Mode

You can specify the mode by giving --mode or the shortcut -m.

cargo run -- --mode <input>
cargo run -- -m <input>
Mode Name Description
start Calculate enhanced parameters from name only
save Generate "Fukkatsu no Jumon" from arbitrary parameters (e.g. exp, gold, etc.)
load Restore name/parameters from the "Fukkatsu no Jumon"
display Supports list and individual display of master data
battle Can battle any monster.

■ Start Mode

Generate parameters from the names of brave men

example

player name: た゛い
summary: PlayerSummary { name: "た゛い\u{3000}", level: 1, hp: 14, mp: 0, gold: 0, experience: 0 }
strength_status: StrengthStatus { level: 1, strength: 4, agility: 4, max_hp: 14, max_mp: 0, attack_power: 4, defense_power: 2, weapon: "なし", armor: "なし", shield: "なし" }

The default setting of the mode is here, so if you omit it, the default brave will be generated

example

cargo run

player name: ゆうてい
summary: PlayerSummary { name: "ゆうてい", level: 1, hp: 15, mp: 0, gold: 0, experience: 0 }
strength_status: StrengthStatus { level: 1, strength: 4, agility: 3, max_hp: 15, max_mp: 0, attack_power: 4, defense_power: 1, weapon: "なし", armor: "なし", shield: "なし" }
item: ["なし", "なし", "なし", "なし", "なし", "なし", "なし", "なし"]

■ Save Mode

Generates the "Fukkatsu no Jumon" from the parameters of the hero.

example

cargo run -- -n だい -m save

ぢばげぞでぶいまももれぎざぞでぶいよごぜ

After giving the options explained above and changing the parameters, the Fufutsu no Jumon can be generated.

cargo run -- -n だい -e 7000 -m save

きがよわげずぢなののみやりわげずてだいか

■ Load Mode

Generates a brave man from the "Fukkatsu no Jumon" of fortune.

example

cargo run -- -m load -p ぢばげぞでぶいまももれぎざぞでぶいよごぜ

new_player from Password
player name: た゛い
summary: PlayerSummary { name: "た゛い\u{3000}", level: 1, hp: 14, mp: 0, gold: 0, experience: 0 }
strength_status: StrengthStatus { level: 1, strength: 4, agility: 4, max_hp: 14, max_mp: 0, attack_power: 4, defense_power: 2, weapon: "なし", armor: "なし", shield: "なし" }

■ Display Mode

cargo run -- -m display --view item
[Equipment { name: "なし", price: 0, sell: 0, attack: 0, defense: 0 }, Equipment { name: "たいまつ", price: 8, sell: 4, attack: 0, defense: 0 }, Equipment { name: "せいすい", price: 12, sell: 6, attack: 0, defense: 0 }, Equipment { name: "キメラのつばさ", price: 24, sell: 12, attack: 0, defense: 0 }, Equipment { name: "りゅうのうろこ", price: 20, sell: 10, attack: 0, defense: 2 }, Equipment { name: "ようせいのふえ", price: 0, sell: 0, attack: 0, defense: 0 }, Equipment { name: "せんしのゆびわ", price: 0, sell: 0, attack: 2, defense: 0 }, Equipment { name: "ロトのしるし", price: 0, sell: 0, attack: 0, defense: 0 }, Equipment { name: "おうじょのあい", price: 0, sell: 0, attack: 0, defense: 0 }, Equipment { name: "のろいのベルト", price: 0, sell: 0, attack: 0, defense: 0 }, Equipment { name: "ぎんのたてごと", price: 0, sell: 0, attack: 0, defense: 0 }, Equipment { name: "しのくびかざり", price: 0, sell: 0, attack: 0, defense: 0 }, Equipment { name: "たいようのいし", price: 0, sell: 0, attack: 0, defense: 0 }, Equipment { name: "あまぐものつえ", price: 0, sell: 0, attack: 0, defense: 0 }, Equipment { name: "にじのしずく", price: 0, sell: 0, attack: 0, defense: 0 }]
cargo run -- -m display --view item 5
item: Equipment { name: "ようせいのふえ", price: 0, sell: 0, attack: 0, defense: 0 }

Display Patterns

  • item
  • weapon
  • armor
  • shield
  • status
  • monster
  • town
  • message

■ Battle Mode

Now, if you have given birth to a brave man, let's head into battle.

Enter commands and defeat the slime!

cargo run -- -m battle

スライムがあらわれた!

ゆうてい HP: 15
スライム HP: 3

--- ゆうていのターン ---
コマンド?
1: たたかう
2: じゅもん
3: どうぐ
4: にげる

If you've been hit, then take on the challenge with the best equipment!

cargo run -- -n だい -o max -m battle

スライムがあらわれた!

た゛い  HP: 190
スライム HP: 3

--- た゛い のターン ---
コマンド?
1: たたかう
2: じゅもん
3: どうぐ
4: にげる

You can fight any monster by specifying the id of the enemy in the --view option.

You can fight the last boss right away.

cargo run -- -n だい -o max -m battle --view 39

りゅうおうがあらわれた!

た゛い  HP: 190
りゅうおう HP: 129

--- た゛い のターン ---
コマンド?
1: たたかう
2: じゅもん
3: どうぐ
4: にげる

Beware of strong flames.

 りゅうおうは  ほのおをはいた!
 た゛い は 44ポイントの
 ダメージを うけた

た゛い  HP: 146
りゅうおう HP: 129

Status Option

--option or the shortcut -o can be used to specify status options

cargo run -- -o <input>

If max is specified, the parameter and story state will be the strongest

example

cargo run -- -o max
player name: ゆうてい
summary: PlayerSummary { name: "ゆうてい", level: 30, hp: 210, mp: 180, gold: 65535, experience: 65535 }
strength_status: StrengthStatus { level: 30, strength: 140, agility: 117, max_hp: 210, max_mp: 180, attack_power: 182, defense_power: 108, weapon: "ロトのつるぎ", armor: "ロトのよろい", shield: "みかがみのたて" }
item: ["りゅうのうろこ", "せんしのゆびわ", "ロトのしるし", "おうじょのあい", "ぎんのたてごと", "たいようのいし", "あまぐものつえ", "にじのしずく"]

Format Option

The output format can be changed by giving the --format.

cargo run -- --format <input>
Format Name Description
print It will be a print statement output. This is the default setting.
json Output in JSON format

Example

Additional Resources

Contributing to Damdara

To contribute to Damdara, follow these steps:

  1. Fork this repository.
  2. Create a branch: git checkout -b <branch_name>.
  3. Make your changes and commit them: git commit -m '<commit_message>'.
  4. Push your changes to your branch: git push origin <branch_name>.
  5. Create a pull request.

Alternatively, consult the GitHub documentation on how to create a pull request.

Other Languages

References

License

This project is licensed under the MIT License. See the LICENSE file for details.

All monsters, images and other copyrights belong to Square Enix.

Author

Daisuke Takayama

Dependencies