FFII Bestiary - For Rpg Maker MZ

GENERAL

Updated to version 1.3.0!

This update focuses on stability, compatibility with existing save files, and several bug fixes reported by users.

FFII Bestiary is a plugin for RPG Maker MZ that adds a clean and classic bestiary system inspired by the monster catalogue seen in Final Fantasy II.

The plugin creates a dedicated Bestiary scene where players can browse registered enemies, check how many times each monster has been defeated, and view customizable enemy information such as HP, MP, parameters, rewards, treasures and more.

It is designed for RPG projects that need a simple, readable and customizable monster archive.

VERSION 1.3.0 UPDATE 

Version 1.3.0 is mainly a bugfix and stability update. This version fixes several issues that could affect real projects, especially when using existing save files or navigating the bestiary detail scene. Main fixes: Fixed locked monsters sometimes appearing as unlocked after loading a save file. Fixed side navigation inside the enemy detail scene. Fixed navigation so it only moves between actually unlocked enemies. Fixed enemy revival handling. Fixed asynchronous image loading issues when changing enemy entries quickly. Fixed treasure previews so drop items are shown deterministically instead of being rolled randomly. Improved compatibility with save files created with previous versions. Improved plugin descriptions and English help text. If you are already using the plugin in a project, updating to this version is strongly recommended.

MAIN FEATURES

• Bestiary system inspired by Final Fantasy II.
• Dedicated enemy list scene.
• Enemy detail / showcase scene.
• Enemy registration system.
• Enemy defeat counter.
• Bestiary completion percentage.
• Customizable bestiary name.
• Customizable locked and unlocked enemy text.
• Customizable battlebacks for each enemy.
• Customizable information window.
• Support for escape codes in displayed text.
• Plugin command to force unlock enemies.
• Plugin command to show or hide the Bestiary command in the menu.
• Compatibility support for VisuStella Main Menu Core.
• RPG Maker MZ side-view enemy support.

HOW ENEMIES ARE REGISTERED

Enemies are registered inside the bestiary when:

• the enemy is defeated;
• the party successfully escapes from a battle containing that enemy;
• the enemy is manually unlocked through the plugin command.

Once an enemy is registered, it becomes available in the Bestiary list and can be opened in the detail scene.

ENEMY DETAILS WINDOW

The detail window is highly customizable. By default, you can show common enemy information such as:

• Defeated count;
• HP;
• MP;
• Attack;
• Defense;
• Magic Attack;
• Magic Defense;
• Speed;
• Luck;
• Accuracy;
• Evasion;
• Experience;
• Gold;
• Treasures.

Each line can be customized from the Plugin Manager. The value field uses JavaScript and assigns the result to the text variable, allowing advanced users to create their own custom information lines. You can also use escape characters / escape codes in both the line name and the displayed value.

CUSTOM BATTLEBACKS

You can customize the battleback images shown behind each enemy in the detail scene.

Add these notetags inside the enemy Note box:

<BestiaryBB1: filename>
<BestiaryBB2: filename>

Example:

<BestiaryBB1: Ground1>
<BestiaryBB2: GrassMaze>

The images are loaded from:

img/battlebacks1/
img/battlebacks2/

If no notetags are used, the plugin will use the default battlebacks selected in the Plugin Manager.

PLUGIN PARAMETERS

Bestiary Name

The name shown in the Bestiary header and used as the menu command name.

Bestiary Completion Format

The text shown in the completion window.

Use %1 to display the completion percentage.

Example:
Monsters Defeated: %1

Default Monster Battleback1

The default battleback1 image used when an enemy does not have a custom notetag.

Default Monster Battleback2

The default battleback2 image used when an enemy does not have a custom notetag.

Locked Text

The text shown when an enemy entry is still locked.

Example:
???

Unlocked Text

The text shown when an enemy entry is unlocked.

Use %1 to display the enemy name.

Example:
%1

Show in Menu

Determines if the Bestiary command is shown in the default RPG Maker MZ menu.

If you are using VisuStella Main Menu Core, please check the compatibility section below.

Info Window Lines

This is the list of information lines shown in the enemy detail window.

Each entry contains:

• Line Name: the name shown on the left;
• Value: JavaScript code that assigns the displayed value to the text variable.

Available variables include:

enemyId

The database ID of the selected enemy.

enemy

A Game_Enemy object created from the selected enemy.

PLUGIN COMMANDS

The plugin includes two Plugin Commands.

Force Unlock Beast

Forcefully unlocks a monster inside the Bestiary.

Use this command if you want to unlock an enemy through an event, story progression, reward, debug command or custom system.

Show Bestiary in Menu

Shows or hides the Bestiary command from the main menu.

This can be useful if you want the Bestiary to become available only after a certain point in the game.

PLUGIN COMPATIBILITY

The plugin includes compatibility handling for VisuStella Main Menu Core.

If VisuStella Main Menu Core is installed, the plugin will not automatically add the Bestiary command to the default menu.

In that case, you can add the command manually through VisuStella Main Menu Core parameters.

You can use the following settings as a starting point:

{"Symbol:str":"_bestiary","Icon:num":"50","TextStr:str":"Bestiary","TextJS:func":"\"\"","ShowJS:func":"\"return !!$gameSystem._showBestiary\"","EnableJS:func":"\"return true\"","ExtJS:func":"\"return null;\"","CallHandlerJS:func":"\"SceneManager.push(Scene_Bestiary)\"","PersonalHandlerJS:func":"\"\""}

You can edit the icon, text, visibility condition or command behavior depending on your project.

RPG MAKER VERSION

The plugin is developed on Rpg Maker MZ - Version 1.10.0 and with the related PIXI.js Version 5.3.12. 

This plugin is NOT compatible with RPG MAKER MV.

TERMS OF USE

• Credits to BlueMoon / Sparrow Tales.
• Credits are required or highly appreciated, depending on the license included with the downloaded package.
• You may edit the code for your own project.
• This plugin can be used in both commercial and non-commercial projects.
• Do not redistribute this plugin as-is.
• Do not incorporate portions of this plugin into another plugin for redistribution.
• Do not remove or alter the plugin header information, filename or parameter names.