Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ckay-9/duelcraft
A Simple Dueling Plugin for Minecraft Servers
https://github.com/ckay-9/duelcraft
1v1 duel fun java minecraft misc multiplayer plugin spigot
Last synced: 7 days ago
JSON representation
A Simple Dueling Plugin for Minecraft Servers
- Host: GitHub
- URL: https://github.com/ckay-9/duelcraft
- Owner: CKAY-9
- License: agpl-3.0
- Created: 2024-07-24T21:54:08.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-07-26T21:01:56.000Z (4 months ago)
- Last Synced: 2024-10-12T03:40:37.381Z (about 1 month ago)
- Topics: 1v1, duel, fun, java, minecraft, misc, multiplayer, plugin, spigot
- Language: Java
- Homepage: https://www.spigotmc.org/resources/duelcraft.118361/
- Size: 3.68 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
###
A Simple Dueling Plugin for Minecraft Servers.
##
Features
- Dueling system
- Win/loss/kills/deaths tracking
- Configurable
- GUI
##
How to Install
1. Download the latest release of DuelCraft
2. Drop the `duelcraft-version.jar` file into your server's `./plugins` folder
3. Reload/restart your server
4. You're done
##
How to Use
Players are able to engage in duels via the command `/duel [opponent_name]`. The opponent will have to accept
the request before the duel starts. Duel requests expire after a configurable amount of time. Additionally, the command `/duel` will open a GUI for players to select who to challenge.
### Commands
- `/duel [player_name]`: If player_name is left blank (e.g. `/duel`), this command will open a GUI menu to interact with DuelCraft. If player_name is provided (e.g. `/duel CKAY_9`), it will try to send a duel challenge to the provided player.
##
Developing (also useful to server owners)
DuelCraft uses Spigot API v1.20.6, but works with (from what I have tested) Minecraft v1.20.6+. The structure of DuelCraft as a system is pretty simple.
### Initialization, onEnable()
- Initialize storage files (config and data) and register tasks, listeners, commands, etc.
### User Interaction
- Handle user inputs, either through the command or the GUI
- (GUI) Either invite/create a duel, accept a duel, or view admin utilities (OP permissions required)
- (Command) Open GUI if no arguments are provided, otherwise send duel challenge to the first argument
### Matches
- Matches have three "phases" (booleans): accepted, started, ended
- Players can't send other invites if they already have an outgoing request
- Once the challenged player accepts, a five second countdown starts where the "arena world" (flat world) is generated (`accepted = true`)
- At the end of the countdown, the players are teleported to the arena world at different locations (`±(arena_radius * 0.5)` on the center X position) and given the items provided in the config (`started = true`)
- Matches end when a player will be below `0.5` HP (half a heart), leave, or just die. Another five second countdown begins, match results are announced (`ended = true`)
- At the end of the countdown, the players are teleported back to their original location (world and position) and given their items back
### Storage
- Player data is saved in a file named `/plugins/DuelCraft/data.yml`
- Players stats are updated at the end of each match
- YAML layout:
```
data.yml
players:
[player_uuid]:
wins: int
losses: int
kills: int
deaths: int
...
```
