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

Ensure your server has Fabric Loader and Fabric API installed
Place FanTPA-x.x.x.jar into the server's mods folder
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

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

Building from Source

Requirements

Java 25 or higher
Git

Build Steps

Clone the repository

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

Build the mod

# Windows
gradlew.bat build

# Linux/macOS
./gradlew build

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.