> For the complete documentation index, see [llms.txt](https://tne.gitbook.io/tne-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tne.gitbook.io/tne-docs/developers/welcome-developers.md).

# 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!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://tne.gitbook.io/tne-docs/developers/welcome-developers.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.