https://github.com/membercat-studios/easytpa
A simple TPA plugin for Minecraft.
https://github.com/membercat-studios/easytpa
easytpa java minecraft-plugin
Last synced: 6 months ago
JSON representation
A simple TPA plugin for Minecraft.
- Host: GitHub
- URL: https://github.com/membercat-studios/easytpa
- Owner: Membercat-Studios
- License: mit
- Created: 2025-02-28T18:54:38.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-13T11:26:19.000Z (over 1 year ago)
- Last Synced: 2025-03-13T12:30:42.220Z (over 1 year ago)
- Topics: easytpa, java, minecraft-plugin
- Language: Java
- Homepage:
- Size: 89.8 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
EasyTPA
Simple, powerful teleport requests for Minecraft servers
[](https://www.minecraft.net/)
[](license)
[](https://www.java.com/)
## ✨ Features
- **Simple Commands** - `/tpa`, `/tpaccept`, `/tpdeny` and more
- **Interactive UI** - Clickable accept/deny buttons with hover text
- **Sound Effects** - Audio feedback for requests and teleportation
- **Customizable** - Fully configurable messages and settings
- **Performance** - Lightweight with minimal resource usage
- **Flexible** - Permission-based access with bypass options
- **Reliable** - Request timeout and cooldown systems
- **Multi-version** - Support for Minecraft 1.19.4 through 1.21.4
## 📋 Commands
| Command | Description | Permission |
| -------------------- | ------------------------------- | ------------------ |
| `/tpa ` | Send a teleport request | `easytpa.tpa` |
| `/tpaccept [player]` | Accept a teleport request | `easytpa.tpaccept` |
| `/tpdeny [player]` | Deny a teleport request | `easytpa.tpdeny` |
| `/tptoggle` | Toggle teleport requests on/off | `easytpa.toggle` |
| `/easytpa reload` | Reload the plugin configuration | `easytpa.admin` |
## 🔑 Permissions
### Basic Permissions
- `easytpa.tpa` - Send teleport requests (default: true)
- `easytpa.tpaccept` - Accept teleport requests (default: true)
- `easytpa.tpdeny` - Deny teleport requests (default: true)
- `easytpa.toggle` - Toggle teleport requests (default: true)
### Advanced Permissions
- `easytpa.admin` - Access admin commands (default: op)
- `easytpa.bypass` - Bypass disabled teleport requests (default: op)
- `easytpa.cooldown.bypass` - Bypass cooldown timers (default: op)
### Permission Groups
- `easytpa.*` - All EasyTPA permissions (default: op)
## ⚙️ Configuration
```yaml
# Time settings
settings:
request-timeout: 60 # Time in seconds before a request expires
cooldown: 30 # Time in seconds between teleport requests
enable-sounds: true # Play sounds for teleport events
# All messages are customizable
messages:
prefix: "&7[&6EasyTPA&7] &r"
# ... and many more messages
```
## 🚀 Installation
1. Download the plugin from the [releases page](https://github.com/Membercat-Studios/easytpa/releases)
2. Place the JAR file in your server's `plugins` folder
3. Restart your server
4. Optionally configure in `plugins/EasyTPA/config.yml`
## 🔧 Troubleshooting
Permission Issues
Problem: Commands not working for players
Solution: Check permissions with /lp user <player> permission info easytpa
Plugin Not Loading
Problem: Plugin fails to load on startup
Solution: Check console for errors and verify you're using compatible Java and Minecraft versions
## 🛠️ Building from Source
```bash
git clone https://github.com/Membercat-Studios/easytpa.git
# build a shaded jar with gradle
./gradlew shadowJar
# find the bundled jarfile in build/libs/
```
## 📝 Support
If you encounter issues or have suggestions, please [open an issue](https://github.com/Membercat-Studios/easytpa/issues) with:
- Server version
- Plugin version
- Java version
- Error messages (if any)
- Steps to reproduce
## 📜 License
This project is licensed under the MIT License - see the [LICENSE](license) file for details.
## 🤝 Contributing
Contributions are welcome! Feel free to submit pull requests or open issues for bugs and feature requests.
---