An utils minecraft plugin for our SMP
  • Java 91.1%
  • Shell 6.6%
  • Batchfile 2.3%
Find a file
2025-10-21 16:15:20 +02:00
.github chore: set executable permission for gradlew script 2025-10-02 11:39:50 +02:00
gradle/wrapper chore: add Gradle wrapper configuration files 2025-10-02 11:40:45 +02:00
src/main Merge pull request #35 from BreizhHardware/hotfix/grave-burn 2025-10-21 13:29:02 +02:00
.gitignore chore: update server configuration for Paper version 1.21.10 2025-10-08 09:32:17 +02:00
build.gradle chore: update main class in Gradle build configuration 2025-10-02 11:36:10 +02:00
bump-version.sh chore: migrate project from Maven to Gradle build system 2025-10-02 11:35:32 +02:00
gradlew chore: migrate project from Maven to Gradle build system 2025-10-02 11:35:32 +02:00
gradlew.bat chore: migrate project from Maven to Gradle build system 2025-10-02 11:35:32 +02:00
README.md chore: migrate project from Maven to Gradle build system 2025-10-02 11:35:32 +02:00
settings.gradle chore: migrate project from Maven to Gradle build system 2025-10-02 11:35:32 +02:00
start-test-server.bat Merge pull request #37 from BreizhHardware/feature/waystone-customization 2025-10-21 13:20:25 +02:00
start-test-server.sh Merge pull request #37 from BreizhHardware/feature/waystone-customization 2025-10-21 13:20:25 +02:00

# CipaUtils

Features

  • Disable Spawn Protection: Instantly disables the vanilla spawn protection, with command toggling and status display.
  • Waystone System: Adds craftable teleportation stones (waystones) for fast travel between locations. Includes commands for giving, listing, renaming, and getting info about waystones.
  • Grave System: Handles player death events for improved item recovery and grave management.
  • Chunk Loader: Keeps chunks loaded around the player for continuous activity, even when they are not nearby.
  • Custom Crafting Recipes: Introduces new crafting recipes for waystones, chunk loaders and invisible light sources.

Commands

Spawn Protection

  • /nomorespawnprotect toggle — Enable/disable spawn protection instantly.
  • /nomorespawnprotect status — Show current spawn protection status.

Waystone

  • /waystone give — Get a waystone item (requires permission cipautils.waystone.give).
  • /waystone list — List all available waystones for the player.
  • /waystone info <name> — Show info about a specific waystone.
  • /waystone rename <new_name> — Rename your nearest waystone (within 5 blocks).

Waystone Crafting Recipe

E D E    E = Ender Pearl
D L D    D = Diamond
O O O    L = Lodestone, O = Obsidian

Permissions

  • cipautils.waystone.give — Allows a player to use /waystone give.

Configuration

A config.yml file is generated in the plugin folder. Main options:

  • disable-spawn-protection: (default true) Instantly disables spawn protection on server start.

Usage

  • Place the plugin jar in your plugins folder and restart the server.
  • Use the provided commands to manage spawn protection and waystones.
  • Waystones can be crafted, placed, and used for teleportation between locations.

Support

For issues, suggestions, or feature requests, please open an issue on the GitHub repository.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request.

Local Development

  1. Clone the repository.
git clone https://github.com/BreizhHardware/CipaUtils.git 
  1. Open the project in your IDE (e.g., IntelliJ IDEA).

  2. Set up a local Minecraft server with the Spigot or Paper API.

bash ./start-test-server.sh

This script will download the necessary server files, compile the plugin, and place the jar in the server's plugins folder.

Git flow

This project use a Git flow branching model. The main branches are:

  • main: The production-ready branch.
  • dev: The development branch where features are integrated before being merged into main.
  • feature/*: Feature branches for new features or improvements.
  • hotfix/*: Hotfix branches for urgent fixes on the main branch.

All the release are automatically generated with GitHub Actions when merging dev into main.