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.