SimpleTrains

A lightweight Minecraft plugin for creating fast-travel rail networks with train stations.

Version: 1.2.0 | API: 1.20+ | Author: AndresTube

---

Features

Core System

• Create train stations on rails with a configurable base block (default: Gold Block)
• Teleport between linked stations using registered minecarts
• Station ownership with transfer capability
• Bidirectional station linking (Public/Private modes)
• Full GUI-based management interface

Station Management

• Create, delete, and configure stations via commands or GUI
• Custom welcome messages with color code support (&)
• Find nearby stations within range
• XP cost system for creation and linking

Minecart Registration

• Use a renamed Name Tag on a minecart to make it "warp-eligible"
• Only registered minecarts can teleport between stations

Link System

• Request-based linking with owner approval
• Public links: Anyone can travel
• Private links: Only station owners can use

Fully Customizable Messages (NEW in 1.2.0)

• All plugin messages are customizable via messages.yml
• Support for color codes and placeholders
• GUI titles, item names, and lore are all editable

---

Commands

| Command | Description | Permission |
|---------|-------------|------------|
| /train set <name> | Create a station | Owner |
| /train delete <name> | Delete a station | Owner/Admin |
| /train link <A> <B> [type] | Link stations (public/private) | Owner of A |
| /train unlink <A> <B> | Remove a link | Owner of either |
| /train transfer <station> <player> | Transfer ownership | Owner/Admin |
| /train near | List nearby stations | All |
| /train gui | Open station management GUI | All |
| /train message <station> <msg> | Set welcome message | Owner/Admin |
| /train accept <A> <B> | Accept link request | Owner of B |
| /train reject <A> <B> | Reject link request | Owner of B |
| /train block <material> | Set creation block | Admin |
| /train help | Show help menu | All |

---

Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| simpletrains.use | Basic commands | true |
| simpletrains.admin | Admin override for all actions | op |
| simpletrains.create | Create new stations | op |

---

Configuration

config.yml

settings:
  creation_block: GOLD_BLOCK      # Block required under rail to create station
  creation_xp_cost: 5             # XP levels to create a station
  link_creation_xp_cost: 3        # XP levels to request a link
  link_acceptance_xp_cost: 2      # XP levels to accept a link
  linking_requires_owner_acceptance: true  # Require approval for links

messages:
  warp_confirm: '&aWarping to %DESTINATION%...'
  station_welcome: '&e>> Welcome to %STATION% station! &6%MESSAGE%'

messages.yml (NEW in 1.2.0)

All plugin messages are now customizable! Edit messages.yml to change any text:

prefix: "&6[SimpleTrains] &r"
station-created: "&aStation '%STATION%' created successfully! (-%COST% XP)"
no-permission: "&cYou don't have permission for this command."
# ... 100+ customizable messages

Placeholders: Use %PLACEHOLDER% format (e.g., %STATION%, %PLAYER%, %COST%)

---

Quick Start

1. Create a station:

   • Place a rail on top of a Gold Block
   • Stand on the rail
   • Run /train set MyStation

2. Register a minecart:

   • Rename a Name Tag in an anvil (any name)
   • Right-click a minecart with it

3. Link stations:

   • Run /train link StationA StationB
   • The owner of StationB must accept the request

4. Travel:

   • Ride your registered minecart to a station
   • Select your destination from the GUI

---

Technical Info

| Setting | Value |
|---------|-------|
| Teleport cooldown | 10 seconds |
| Player detection radius | 20 blocks |
| Near command range | 500 blocks |
| Data storage | YAML (auto-save) |
| Minecraft versions | 1.20.x, 1.21.x+ |
| Java version | 17+ |

---

Changelog

v1.2.0

• Added complete messages system (messages.yml)
• All plugin text is now fully customizable
• GUI titles, item names, and lore can be edited
• Support for placeholders in all messages

v1.1.0

• Added support for Minecraft 1.20.x+
• Lowered Java requirement from 21 to 17
• Improved backwards compatibility

v1.0.0

• Initial release
• Station creation and management
• Minecart registration system
• Link request system with approval
• GUI interface

---

Support

For issues or suggestions, contact AndresTube or open an issue on the repository.