Welcome Developers

Welcome Developers to TheNewEconomy (TNE)

Welcome to the Developer's Guide for TheNewEconomy (TNE), a powerful and flexible economy plugin for Minecraft servers. This guide is designed to help you extend and customize TNE’s features to meet the unique needs of your server.

Whether you’re adding new functionality, integrating with external systems, or enhancing the existing economy, TNE’s modular design and API provide the tools you need to succeed.

---

Developer Capabilities

1. Custom Account Types

Define new types of accounts that extend beyond player accounts, such as town or nation accounts. Learn how to manage these accounts and their unique identifiers for advanced integrations.

2. Custom Balance Handlers

Create handlers that add or retrieve holdings from various sources, such as inventories, virtual balances, experience levels, or even custom storage systems like banks.

3. Custom Account Statuses

Introduce unique statuses for accounts, such as locked, restricted, or frozen, and control how accounts interact with the economy based on their status.

4. Custom Balance Format Rules

Customize how balances are displayed using the Format configuration in currency YAML files. Add rules to enhance formatting with symbols, decimal separators, or custom placeholders.

5. Custom Currency Loader and Saver

Create loaders and savers to manage how currencies and their denominations are read from and written to storage, enabling integration with custom file formats or databases.

6. Custom Currency Types

Define new types of currencies that extend beyond the default virtual or item-based options. Implement types like mixed currencies, experience-based systems, or entirely unique mechanisms.

7. Custom Transaction Checks

Add checks to validate and enforce rules during transactions, such as ensuring minimum balances, restricting currencies, or applying special conditions.

8. Custom Tax Types

Develop unique tax calculation mechanisms, such as flat fees, percentage-based taxes, or dynamic tax rules, to customize how taxes are applied to transactions.

9. Custom Transaction Types

Introduce new financial operations beyond deposits, withdrawals, and payments. Define unique behaviors and taxation rules for your custom transaction types.

---

Why Extend TNE?

TNE provides a robust foundation for managing complex economies, but its true power lies in its flexibility. By leveraging TNE’s developer tools, you can:

• Tailor the economy to fit your server’s gameplay.

• Integrate with third-party plugins and systems.

• Expand the plugin’s functionality with custom logic.

---

Getting Started

1. Review the key concepts and examples provided in this guide.

2. Use TNE’s API and modular design to extend its capabilities.

3. Test your custom implementations in a controlled environment before deploying to your live server.

---

Support and Contribution

TNE is an open-source project, and contributions are always welcome! If you’d like to report an issue, suggest a feature, or contribute code, visit the official GitHub repository.

Let’s build better economies together!