Skip to main content

Numerical Storage

Versatile system for managing currencies, mana pools, and upgraded bank accounts.

The Numerical Storage Extension provides a generic framework for managing numeric data. Use it to create custom currencies, RPG stat pools, or upgradable bank accounts with interest rates and GUI management.

Source Code

View source on GitHub.

Download Releases

Get the latest JARs.

Definition

Define currency rules, interest, and limits.

Bank Levels

Configure upgrade tiers and capacities.

Menu Config

Customize the banking interface.

Features

  • Multi-Currency: Define unlimited unique storages (Gold, Tokens, Mana).
  • Leveling System: Players can upgrade their storage to increase capacity and interest rates.
  • Interest: Scheduled interest payouts based on Cron expressions.
  • Banking GUI: Complete interface for depositing, withdrawing, and upgrading.

Quick Start

1. Configure Settings

Start with the configuration entry: definition. This defines global settings for the extension.→ definition

Commands

All commands use the /ns prefix.
CommandDescriptionPermission
/ns open <id>Open storage menu.typewriter.ns.open
/ns add <id> <amount>Add balance (Console).typewriter.ns.add
/ns remove <id> <amount>Deduct balance (Console).typewriter.ns.remove
/ns level <id> <value>Set level (Console).typewriter.ns.level
/ns reset <id>Wipe data (Console).typewriter.ns.reset

Placeholders

Use these placeholders to display values. Replace <id> with your storage Definition ID.
PlaceholderDescription
%typewriter_ns_balance_<id>%Current balance.
%typewriter_ns_level_<id>%Current level index.
%typewriter_ns_capacity_<id>%Max balance capacity.
%typewriter_ns_interest_<id>%Current interest rate.
%typewriter_ns_interest_cooldown_<id>%Time until next payout.
%typewriter_ns_name_<id>%Display name.
%typewriter_ns_prefix_<id>%Currency prefix symbol.

Dependencies

ExtensionRequiredUsage
GUI ExtensionRequiredMenu rendering and layout system.
PlaceholderAPIOptionalFor @Placeholder fields.