EasyMoneyAddon

NPC Bank

Each NPC can be a separate bank. A player has a separate savings account at every bank NPC, and their account is shared normally with their FTB Teams team only where FTB Quests controls quest progress; bank money itself belongs to the individual player.

Fastest setup: open the bank on interaction

This is the recommended setup. It uses the existing Easy NPC editor and requires no commands, UUIDs, or dialog configuration.

1. Edit the NPC with the Easy NPC configuration GUI.
2. Open Action Events, then select On Interaction.
3. Add an action and select Custom as its action type.
4. Enter easymoneyaddonmod:bank_menu as the custom action ID. Leave arguments empty.
5. Do not select Command. Commands are intentionally guarded by Easy NPC's command allowlist and cannot invoke the bank action.
6. Remove any Open Default Dialog or Open Trading Screen action from this event, or move bank_menu below them so it executes last.
7. Save the NPC.

Right-clicking the NPC now opens the bank menu. The bank menu contains deposit and withdrawal controls for 1, 10, 100, 1,000, and all available money, plus wallet and savings balances.

Easy NPC 7.11.0 does not offer an API that lets add-ons insert a new configuration tab or checkbox in its editor. Action Events -> On Interaction -> Custom Action -> bank_menu is the supported in-GUI equivalent of enabling the bank option for an NPC. It stores the setup with the NPC, survives restarts, and works with every Easy NPC type.

Dialog-button setup

Use this when the player should read NPC dialogue and explicitly select a bank option.

1. Edit the NPC, then create or select a dialog in the Easy NPC dialog editor.
2. Add a dialog button, such as Open Bank.
3. Configure that button's action type as Custom (not Command).
4. Enter easymoneyaddonmod:bank_menu with no arguments.
5. Save the dialog and NPC.

The player opens the dialogue normally and selects the button to open the same bank menu. You can freely customize the dialog text, button text, NPC appearance, and other dialog buttons.

Bank action IDs

The bank menu is the simplest setup. The fixed-value actions remain available for custom dialog flows.

Amounts must be finite positive decimal numbers. For example, use 10, 10.5, or 250.00. Amounts are stored and processed to two decimal places.

Bank safety and configuration

These server-wide settings apply to every NPC bank:

For a deposit fee, the player pays the entered amount and the account receives the amount after the fee. For a withdrawal fee, the account loses the entered amount and the player receives the amount after the fee. If a fee would leave no money to credit or pay, the transaction is rejected.

Bank menus remain valid only while the player is within 8 blocks of the source NPC. They close if the player walks away or the NPC is no longer available. Shift-clicking cannot move bank-menu items. Successful and rejected transactions are written to the server log as BANK_AUDIT.

Savings data is stored with the overworld in easymoneyaddonmod_npc_banks. It persists through restarts. Interest is calculated from real time, including time while the server is offline.

Money actions

Add an Easy NPC Custom Action and set one of the following IDs:

pay_for_task checks the task before taking money. If the task ID is invalid, unavailable, locked by quest progression, or already complete, it does not charge the player. Task IDs are decimal FTB task IDs, not quest IDs.

Selling an NPC item or service

Add easymoneyaddonmod:pay as a Custom action on the dialog button or interaction with the price as its only argument. It debits the player's DiceMCMM wallet only when it has the full price. Use pay_for_task for a service that should also complete an FTB Quests task. Configure paid item or service rewards through the corresponding FTB Quests reward, since Easy NPC action sequences do not conditionally stop later actions when a custom action rejects payment.

FTB Quests integration

Easy NPC Interaction task

The addon adds the Easy NPC Interaction task type to FTB Quests.

1. Create and save the Easy NPC.
2. In FTB Quests edit mode, add an Easy NPC Interaction task to a quest.
3. Set the task's npc_uuid field to the NPC entity UUID.
4. Save and exit edit mode.

Right-clicking that NPC completes every available matching task for the interacting player's FTB team. This works with Basic Dialogue, configured dialog, direct-open banks, and dialog-button banks. The task writes actual completed FTB progress and triggers normal FTB Quests completion events, rewards, and notifications.

To find the UUID, right-click the NPC and locate this Easy NPC server-log format:

Opening menu <menu-uuid> for npc <npc-entity-uuid> and player <player>

Use the value after for npc, not the menu UUID, NPC display name, dialog ID, or FTB task ID. An empty npc_uuid intentionally never matches an NPC.

Easy NPC Custom Action task

The Easy NPC Custom Action task completes when a configured EasyMoney Addon action successfully runs at a configured NPC.

1. Add Easy NPC Custom Action to the FTB Quest.
2. Set npc_uuid to the NPC entity UUID.
3. Set action_id to an action ID, such as easymoneyaddonmod:bank_deposit.

For bank_menu, the task completes when the bank menu opens. For deposit or withdrawal tasks, it completes only when the transaction succeeds.

Easy NPC Payment task

The Easy NPC Payment task completes when a player successfully spends, pays, or uses pay_for_task at the configured NPC for at least minimum_amount. Set npc_uuid to the NPC entity UUID and set the minimum payment required. This is useful for paid NPC items, services, and access fees.

Easy NPC Bank Transaction task

The Easy NPC Bank Transaction task completes after a successful bank deposit or withdrawal at the configured NPC. Set operation to deposit, withdraw, or either, and set minimum_amount to require a minimum transaction size. The task never completes from a rejected transaction.

Troubleshooting

When an NPC interaction completes a matching FTB task, the server log includes:

Completed <count> Easy NPC interaction task(s) for player <player> at