FanTPA

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

| Command | Description | Permission |
|———|————-|————|
| /tpa <player> | Send teleport request to another player | All players |
| /tpahere <player> | Request another player to teleport to you | All players |
| /tpaccept <player> | Accept teleport request | All players |
| /tpdeny <player> | Deny teleport request | All players |

Home System

| Command | Description | Permission |
|———|————-|————|
| /home [name] | Teleport to your home (default home if no name specified) | All players |
| /sethome [name] | Set current location as home (default home if no name) | All players |
| /delhome <name> | Delete specified home | All players |

Back Feature

| Command | Description | Permission |
|———|————-|————|
| /back | Return to last death or teleport location | All players |

Admin Commands

| Command | Description | Permission |
|———|————-|————|
| /tpall | Teleport all online players to your location | OP only |

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

| Option | Type | Default | Description |
|——–|——|———|————-|
| teleport.timeout | int | 30 | TPA request timeout, auto-cancelled if not responded |
| teleport.cooldown | int | 5 | Cooldown between teleports to prevent spamming |
| teleport.delay | int | 3 | Delay before teleportation, allows canceling |
| language.default-language | string | “en_us” | Default language for the mod |
| commands.*.enabled | boolean | true | Enable/disable specific commands |

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

1. Build the mod

# Windows
gradlew.bat build

# Linux/macOS
./gradlew build

1. 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.