FanTPA

Minecraft 版本： 26.1 26.1.1 26.1.2

平台： fabric

标签： management utility

FanTPA

A powerful Minecraft Fabric teleportation mod that provides TPA, Home, Back and other teleportation features with advanced capabilities.

中文版本 | English

Features

Core Features

• Asynchronous Chunk Loading - Advanced async chunk loading system ensures smooth teleportation without server lag
• Custom Language Support - Full support for custom translations with 17+ built-in languages
• High Version Compatibility - Supports Minecraft 26.1+

TPA Teleportation System

Home System

Back Feature

Admin Commands

Advanced Features

Asynchronous Chunk Loading

FanTPA implements an advanced asynchronous chunk loading mechanism that:

• Loads destination chunks in the background without blocking the main thread
• Provides smooth teleportation experience even in remote locations
• Prevents server lag during teleportation operations

Custom Language Support

• 17+ built-in languages with full translation coverage
• Easy-to-use language configuration system
• Support for adding custom language packs

High Version Compatibility

• Server version requirement: >= 26.1
• Regular updates to support latest Minecraft versions

Installation

Server Installation

1. Ensure your server has Fabric Loader and Fabric API installed
2. Place FanTPA-x.x.x.jar into the server's mods folder
3. Start the server, the mod will automatically generate config files

Client Installation (Optional)

• If you want to use in single player, install Fabric Loader and Fabric API as well
• Place the mod in client's mods folder

Configuration File

The mod will automatically generate a config file at config/fantpa/fantpa.conf on first run.

Config Structure

fantpa {
    teleport { 
        timeout = 30    # TPA request timeout in seconds
        cooldown = 5    # Teleport cooldown in seconds
        delay = 3       # Teleport delay in seconds
    }
    language { 
        default-language = "en_us"  # Default language setting
    }
    commands {
        tpa { enabled = true }      # Enable /tpa command
        tpahere { enabled = true }  # Enable /tpahere command
        back { enabled = true }     # Enable /back command
        home { enabled = true }     # Enable /home command
        sethome { enabled = true }  # Enable /sethome command
        delhome { enabled = true }  # Enable /delhome command
    }
}

Config Options

How to Modify Config

1. Stop the server
2. Edit config/fantpa/fantpa.conf file
3. Save and restart the server

Building from Source

Requirements

• Java 25 or higher
• Git

Build Steps

1. Clone the repository

   git clone https://github.com/yourusername/FanTPA.git
   cd FanTPA

2. Build the mod

   
   # Windows
   gradlew.bat build

Linux/macOS

./gradlew build

3. **Get the output**
Built jar file will be located at `build/libs/FanTPA-1.0.0.jar`

### Development Commands

| Command | Description |
|---------|-------------|
| `gradlew runClient` | Launch development client |
| `gradlew runServer` | Launch development server |
| `gradlew build` | Build the mod |
| `gradlew sourcesJar` | Generate sources jar |

## Supported Languages

| Code    | Language              |
|---------|-----------------------|
| `zh_cn` | Chinese (Simplified)  |
| `zh_tw` | Chinese (Traditional) |
| `en_us` | English               |
| `de_de` | German                |
| `es_es` | Spanish               |
| `fr_fr` | French                |
| `ja_jp` | Japanese              |
| `ko_kr` | Korean                |
| `lzh`   | Chinese (Literary)    |
| `pt_br` | Portuguese (Brazil)   |
| `ru_ru` | Russian               |
| `it_it` | Italian               |
| `pl_pl` | Polish                |
| `tr_tr` | Turkish               |
| `th_th` | Thai                  |
| `vi_vn` | Vietnamese            |
| `uk_ua` | Ukrainian             |

## Event System

The mod provides rich events for other mods to listen:

- `TpaRequestEvent` - Fired when a TPA request is sent
- `TpaHereRequestEvent` - Fired when a TPAHere request is sent
- `TpaAcceptEvent` - Fired when a teleport request is accepted
- `TpaDenyEvent` - Fired when a teleport request is denied
- `HomeSetEvent` - Fired when a home is set
- `HomeTeleportEvent` - Fired when teleporting home
- `BackEvent` - Fired when using `/back`
- `TeleportEvent` - Fired when a teleport occurs

## Technical Information

- **Mod ID**: `fantpa`
- **Version**: 1.0.0
- **Minecraft Version**: 1.20.1+
- **Server Version Requirement**: >= 26.1
- **Dependency**: Fabric API

## License

MIT License

## Contributing

Contributions are welcome! Feel free to submit issues and pull requests.