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

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

Supported Languages

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.