ST Bank System

GUIDE FOR BANKSYSTEM 2.1.0

1. Installation
--------
Requirements:
1. Minecraft 1.21.1
2. Java 21
3. Paper 1.21.1 or Arclight/NeoForge 1.21.1.
4. STR ContentServer.zip resource pack
(https://www.curseforge.com/minecraft/texture-packs/str-contentserver/preview)

Installation procedure:
1. Stop the server.
2. Make a backup copy of the plugins/BankSystem and
   plugins/CriminalPursuitSystem folders if the plugins have already been used.
3. Place BankSystem-2.1.0.jar in the plugins folder.
4. Start the server. The plugins will create their own folders and configuration files.
5. Configure the config.yml files for both plugins and the messages.yml file for the plugin.
6. Install STR ContentServer.zip to the resourcepacks client folder and enable it in the resources menu.
7. Set the prison point separately with the command /setjailzone, acceptance center
   with the /setintakezone command and the jail.radius/intake.radius radii.
8. For the escape mechanics, set /setescapezone and both wall points with the commands
   /setescapewall 1 and /setescapewall 2. Until then, escape remains disabled.

2. BankSystem: basic mechanics
--------
Bank accounts
The account balance consists of real items in a physical bank safe.
The banker creates an account, issues a card and a safe‑deposit box, and then sets a PIN code for the card. The card contains the account number and is used in ATMs, cash desks, and vending machines. Lost cards and safe‑deposit boxes can be reissued.

ATMs
The ATM has a physical supply of currency in its own hidden barrel. The main menu allows you to top up the account, transfer and withdraw currency, and pay fines. Before the operation, the player selects a card from the inventory and enters the PIN code.
Withdrawal is possible only if the required currency is available simultaneously in the account and in the ATM.

Payment of fines
At the ATM, the player selects a fine, a bank card, enters the PIN code, and marks the required currency items in the account. The fine amount is removed from the system.

Each police officer in the network receives a configured percentage of the paid amount to their first created active bank account. The payment is made in the commission.main-resource currency. If there is no suitable account, no payment is created for this police officer.

Cash registers
The cash register sells the final stock of items from the adjacent inventory container.
The owner, using Shift+RMB, selects the currency, inventory container, monetary expansions, non-cash payment account, and assigns prices to the items. LMB in the catalog buys one item for cash, RMB — with a bank card.

Cash is stored in the base of the cash register and the selected adjacent containers.
On Arclight, the cash register supports multi-block storage using Create create:item_vault. It is enough to attach one adjacent Vault block: the entire combined structure will be used as a single storage unit.

Vending machines
The vending machine is installed and configured by the administrator. Its hidden barrel  is the final goods warehouse. Goods are added via the service menu.
The vending machine does not have a money container, an attached bank account, or a robbery mechanics.

Robberies
The loot item is specified in config.yml. Robbing the cash register takes the available cash and triggers a reload. When robbing an ATM, the player must press all active panels within a limited time. Success yields the ATM’s physical stock, while failure triggers an alarm. A wanted alert for robberies is automatically passed to CriminalPursuitSystem.

Physical machines The ATM, cash register, and vending machine use a real barrel as a server storage.
For the player, the base is hidden, and the model, signature, interaction zone, and
collision are restored automatically. Normal deletion is allowed after
emptying the associated repositories. The force option throws the contents nearby.

4. BankSystem Teams
--------
/ bankcreate <BankID> <player>
  Create a bank account for the specified online player. The banker executes the command
  the relevant bank.

/bankcardcode <card number> <PIN>
  Set or change the card PIN code.

/bankcardreissue <card number>
 Issue a new copy of the bank card.

/bankvaultreissue <card number>
 Issue a new bank vault and reset the old binding.

/bankdelete <card number>
 Delete the bank account and the associated fee rules.

/bankpincancel
 Cancel the active PIN code input in the chat.

/bankpercent <your bank> <commission card> <other bank> <percentage>
 Configure interbank commission from 1 to 100 percent. The commission card must belong to the original bank and have an established cell.

/bankpercent <your bank> - <other bank> 0
 Delete the interbank commission rule.

/bankatm create
 Create an ATM at the player’s position.

/bankatm remove [force]
  Remove the nearest bank ATM within a 5‑block radius.

/bankatm list
  Show the list of installed bank ATMs.

/bankatmmodel give <player> [quantity]
  Give a bank ATM as an item. The person who installed it becomes its owner.
  player.

/bankcashregister give <player> [quantity]
  Give a cash register item.

/bankcashregister list
  Show the list of installed cash registers.

/bankcashregister remove [force]
  Remove the nearest cash register within a 5‑block radius.

/bankvending give <player> [quantity]
  Give a vending machine item.

/bankvending list
  Show the list of installed vending machines.

/bankvending remove [force]
 Remove the nearest vending machine within a 5‑block radius.

FORCED REMOVAL IF NOT REMOVED
/bankatmremove
/bankcashregisterremove
/bankvendingremove

ANTI‑SPAM
/bankantispam <on|off>

/maskgive <player> [quantity]
 Give the player a criminal mask.

3. Rights
--------

criminalpursuit.police
  PCP, wanted, fines, search, handcuffs, arrest, police notifications
  and payments.

criminalpursuit.admin
  Prison configuration, mask issuance and administrative patrol.

criminalpursuit.player
  Regular player commands. The right is granted to everyone by default.

criminalpursuit.jail.configure
  Setting up the jail, reception, escape zones, and walls. Inherited by admin.

criminalpursuit.jail.manage-sentence
 Modifying and early termination of sentences. Inherited by police and admin.

criminalpursuit.jail.manage-star-duration
 Modifying the automatic sentence minutes per star. Inherited by police and admin.

criminalpursuit.jail.arrest-bypass
  Administrative arrest without handcuffs, search, or intake. Inherited from admin.

criminalpursuit.escape.use
  Initiating an escape. Inherited from criminalpursuit.player.

criminalpursuit.escape.wall-bypass
  Editing a closed wall. The bypass does not work during opening.

banksystem.admin
  Full administrative access to BankSystem.

banksystem.admin.atm
  Creating, viewing, and managing ATMs.

banksystem.admin.cashregister
  Issuing, viewing