YAML API

# YAML API

YAML API is a specialized library that simplifies working with YAML configuration files in Bukkit/Spigot/Paper plugins. It provides a robust and consistent interface for loading, saving, updating, and managing YAML-based configurations, along with advanced mapping capabilities for configuration sections and configurable units.

—

## Overview

The **YAML API** package offers a set of tools designed to handle YAML configuration files efficiently. It abstracts the complexity of file I/O and reflection-based configuration parsing, allowing you to focus on using configuration data in your plugin.

Key components include:

– **YAMLFile**: A class to load, save, and update YAML configuration files.
– **ResourceUtils**: Utility methods for handling resources and file operations.
– **Configurable & ConfigurableFile**: Interfaces and classes that provide easy access to the underlying `FileConfiguration`.
– **ConfigurableUnit**: An interface representing a configuration unit, useful for handling permissions or groups in the configuration.
– **Mappable, SectionMappable, UnitMappable & HashMappable**: A set of interfaces and classes for mapping configuration sections and units into Java collections.
– **YAMLUpdater**: A class that updates YAML files by merging default values and preserving comments.

—

## Key Features

– **Unified Configuration Management**:
Provides a consistent API for reading, writing, and updating YAML configuration files.

– **Dynamic Mapping and Conversion**:
Supports mapping configuration sections to custom units and collections, making it easier to work with complex configuration structures.

– **Resource and File Utilities**:
Includes helper classes to simplify file loading, resource saving, and directory management.

– **Comment Preservation and Updates**:
YAMLUpdater handles merging of default configuration values while preserving existing comments.

– **Reflection-Based Parsing**:
Uses reflection to dynamically access configuration sections and values, ensuring compatibility across server versions.

—

## Usage Example

Below is an example demonstrating how to use the YAML API to load, update, and work with configuration files.

### Example: Using ConfigurableFile and YAMLFile

“`java
package com.example.myplugin;

import me.croabeast.file.ConfigurableFile;
import me.croabeast.file.YAMLFile;
import org.bukkit.configuration.file.FileConfiguration;
import org.bukkit.plugin.java.JavaPlugin;

import java.io.IOException;

public class MyPlugin extends JavaPlugin {

private ConfigurableFile config;

@Override
public void onEnable() {
try {
// Create a new configuration file located in the “config” folder
config = new ConfigurableFile(this, “config”, “settings”)
// Optionally, override methods to control updatability or other behaviors
{
@Override
public boolean isUpdatable() {
// Retrieve the “update” key from the configuration to decide if updates are allowed
return get(“update”, false);
}
};
// Save the default configuration if not present
config.saveDefaults();
// Update the configuration file (merges defaults and preserves comments)
config.update();
} catch (IOException e) {
e.printStackTrace();
}

// Access configuration values
String prefix = config.get(“lang-prefix”, “&e MyPlugin »&7”);
getLogger().info(“Language prefix: ” + prefix);
}
}
“`

### Example: Working with Mappable and SectionMappable

“`java
package com.example.myplugin;

import me.croabeast.file.SectionMappable;
import me.croabeast.file.ConfigurableFile;
import org.bukkit.configuration.ConfigurationSection;
import org.bukkit.plugin.java.JavaPlugin;

public class MyPlugin extends JavaPlugin {

private ConfigurableFile config;

@Override
public void onEnable() {
try {
config = new ConfigurableFile(this, “config”, “settings”);
config.saveDefaults();
config.update();
} catch (Exception e) {
e.printStackTrace();
}

// Assume we have a configuration section “advancements”
ConfigurationSection section = config.getConfiguration().getConfigurationSection(“advancements”);
if (section != null) {
// Create a SectionMappable from the configuration section
SectionMappable.Set sectionMap = SectionMappable.asSet(section.getValues(false));
// Process the mapped configuration as needed
getLogger().info(“Loaded advancements: ” + sectionMap);
}
}
}
“`

—

## Maven / Gradle Installation

To include YAML API to the project, add the following repository and dependency to your build configuration. Replace `${version}` with the desired version tag.

### Maven

Add the repository and dependency to your `pom.xml`:

“`xml


croabeast-repo
https://croabeast.github.io/repo/

me.croabeast
YAML-API
${version}
compile


“`

### Gradle

Add the repository and dependency to your `build.gradle`:

“`groovy
repositories {
maven {
url “https://croabeast.github.io/repo/”
}
}

dependencies {
implementation “me.croabeast:YAML-API:${version}”
}
“`

Replace `${version}` with the appropriate module version.

—

## Conclusion

**YAML API** is a powerful library for managing YAML configurations in your Bukkit/Spigot/Paper plugins. It streamlines file operations, mapping, and updates while preserving comments and ensuring compatibility across server versions. Whether you are building simple configuration systems or working with complex, nested settings, YAML API provides the tools you need to efficiently manage your plugin’s configuration.

Happy coding!

— *CroaBeast*

Yamete Ghast

This texture pack makes the ghast make a funny face when it throws a fireball.
This pack does not require Optifine or EMF, ETF, or ETF to work.
It works on versions lower than 1.21.5.

Yamakashi skateboards

## For correct work you need Optifine or [CITResewn](https://modrinth.com/mod/cit-resewn)

Rename your sword “Огрызок”, “Алмаз”, “Кроссовок”, “Пивас” to make it a skateboard.
If you hold the object in your other hand, it will be behind your back.


yadoomi’s Purple Haze Font

# What does this resource pack add?
This resource pack takes the font from a PvP resource pack called “Purple Haze” and puts it in a seperate resource pack.

Here is a showcase video of the resource pack “Purple Haze” by OmnicronGaming

## Other details.
– This resource pack just takes the font from an already existing resource pack, if you are using this somewhere and want to credit someone, credit TerribleChoices, the creator of “Purple Haze”.
– You can use this resource pack in a modpack without my permission, thats alright.
– This resource pack works on ANY version below 1.8.9, even snapshots.

Hide In Grass

# Hide In Grass
You can become invisible as long as you stand in tall grass, even tall flowers can be used!
Suitable for some small games. 🙂
(This is my practice project while learning DataPack, so it’s a bit rough)

xWorldBlocker


# 🛡️ xWorldBlocker | Total Control Over Your World Access!

> **The ultimate lightweight solution to secure your server’s exclusive areas.**

Have you ever needed to restrict access to a specific world? Whether it’s for a **VIP zone**, a **temporary event**, or a **staff-only area**, **xWorldBlocker** is your solution.

This powerful plugin allows you to block entry to any world on your server, granting access only to players with the specific permissions you define. No complicated setups—just total control.

—

> ## 🚀 Key Features

* **🛡️ Secure World Blocking:** Easily define a list of worlds that remain locked to the public.
* **🔑 Granular Permission System:** * Access a specific world: `xworldblocker.bypass.`
* Access ALL worlds: `xworldblocker.bypass.*`
* **🎨 Full RGB Support:** Custom messages with **HEX colors** (`&#RRGGBB`) and standard Minecraft codes (`&a`, `&l`).
* **⚡ Ultra Lightweight:** Designed for performance. Zero impact on your server’s TPS.
* **⚙️ Instant Reload:** Apply changes instantly with `/xwb reload`—no restart required.

—

> ## 🎮 Commands & Permissions

| Command | Description | Permission Node |
| :— | :— | :— |
| **/xwb help** | Displays the help menu. | None (Public) |
| **/xwb reload** | Reloads the configuration file. | `xworldblocker.admin` |

### Access Permissions
| Permission | Description |
| :— | :— |
| `xworldblocker.bypass.` | Allows entry to a specific locked world. |
| `xworldblocker.bypass.*` | Grants access to **all** blocked worlds. |

—

> ## 🔧 Configuration (`config.yml`)

“`yaml
# __ __ _ _ ___ _ _
# __ __/ / / ___ _ __| | __| | / __ | ___ ___| | _____ _ __
# / / / / / _ | ‘__| |/ _` |/__// |/ _ / __| |/ / _ ‘__|
# > < / / (_) | | | | (_| / / | (_) | (__| < __/ | # /_/_ / / ___/|_| |_|__,______/_|___/ ___|_|____|_| # xPlugins - WillfryDev - 777 Studios # List of worlds to block. # Permission required: xworldblocker.bypass.
blocked-worlds:
– “events”
– “staff_zone”
– “world_vip”

# Messages support HEX (&#RRGGBB) and & codes.
messages:
reload: “&#A2E4B8 ✔ Done! &#C1FFD7The xWorldBlocker configuration has been reloaded.”
no-permission-entry: “&#FFB6C1 ✘ Error! &#FFDDC1You do not have permission to enter this world.”
no-permission-command: “&#FFB6C1 ✘ Error! &#FFDDC1You do not have permission to use this command.”
help:
– “”
– “&#A2E4B8/xwb reload &#87CEEB- Reload the plugin settings.”
– “&#A2E4B8/xwb help &#87CEEB- Display this help message.”
– “”
“`

> ### 📥 Installation

1. Download the “.jar“ file.
2. Drop it into your “/plugins/“ folder.
3. Restart your server.

Configure your worlds in “config.yml“ and run “/xwb reload.“

XTransfer


# 0 What the heck is this?

A new plugin designed to **transfer players’ data between names or UUIDs**. I didn’t find any other plugin can handle this problem before, so I made my own one and uploaded it to here to help anyone who needs this feature for his/her server.

# 1 Features

## 1.1 Smart UUID Detection

Automatically detects UUIDs from:
– Online players
– usercache.json (for premium players)
– Offline-mode UUID generation

## 1.2 Complete Data Transfer

Transfers all vanilla player data:
– Player inventory and Ender Chest (`playerdata/`)
– Statistics (`stats/`)
– Advancements (`advancements/`) for 1.13+

## 1.3 Safe & Reliable

– Creates automatic backups before overwriting
– Kicks online players to prevent data overwrite (configurable)
– Asynchronous file operations – no server lag!

# 2 Commands and Permission Nodes

## 2.1 Commands

“`markdown
– /xtransfer – Show version info
– /xtransfer transfer – Transfer by player names
– /xtransfer transferuuid – Transfer by UUIDs
– /xtransfer list – List all player data files
– /xtransfer list – Show files for specific player
– /xtransfer reload – Reload configuration
– /xtransfer help – Show the help message

/xtf = /transfer = /xtransfer
“`

## 2.2 Permission Nodes

“`markdown
– xtransfer.manage – Allows using all XTransfer commands (default: op)
“`

# 3 Config

“`yaml
# Show logo when plugin enabled
show_logo: true

# World settings
world:
# Manual world name (only used if auto-detect is false)
name: “world”
# Automatically detect world name from server
auto-detect: true

# Transfer settings
transfer:
# Transfer statistics files
stats: true
# Transfer advancements files (1.13+)
advancements: true

# Backup settings
backup:
# Create backup of existing files before overwriting
create: true
# Suffix for backup files
suffix: “.old”

# Online player handling
# If true, kick online players before transfer
# If false, show warning but continue
kick-online-player: true

# Language settings
language: “en”

# Debug mode (enable only for troubleshooting)
debug: false

# Messages – You can customize all messages here
messages:
# English messages
en:
no-permission: “&cYou don’t have permission!”
usage-header: “&9&lX&f&lTransfer &f&lHelp”
usage-transfer: “&7/xtransfer transfer &f ”
usage-transferuuid: “&7/xtransfer transferuuid &f ”
usage-list: “&7/xtransfer list &f[player]”
usage-reload: “&7/xtransfer reload”
usage-help: “&7/xtransfer help”
reload-success: “&a✓ Configuration reloaded!”
transfer-start: “&eStarting async transfer…”

looking-up: “&eLooking up UUIDs for &f{old} &eand &f{new}&e…”
uuid-not-found: “&cCould not find UUID for: &f{name}”
try-uuid: “&7Try using /xtransfer transferuuid with direct UUIDs”
invalid-uuid: “&cInvalid UUID format! Use: /xtransfer transferuuid ”
uuid-example: “&7Example: 12345678-1234-1234-1234-123456789012”

source-data-missing: “&cSource player {name} ({uuid}) has no data file!”

transfer-from: “&7From: &f{name} &7({uuid})”
transfer-to: “&7To: &f{name} &7({uuid})”
transfer-file: “&7File: &f{file}”
backup-created: “&7Backed up existing file to: &f{file}”
transfer-success: “&a✓ Successfully transferred player data!”
transfer-stats: “&7✓ Transferred stats file”
transfer-advancements: “&7✓ Transferred advancements file”
transfer-error: “&cError during transfer: {error}”

folder-not-found: “&cPlayer data folder not found: {path}”
source-not-found: “&cSource file not found: {file}”
source-location: “&7Looked in: {path}”

player-online-warning: “&e⚠ Warning: Player {player} is online! Data may be overwritten when they log out.”
player-kicked: “&e✓ Player {player} has been kicked for data transfer.”
kick-message: “&cYour data is being transferred. Please rejoin in a few seconds.”

no-files: “&eNo player data files found”
list-header: “&6=== Player Data Files ({count}) ===”
list-more: “&7… and {count} more”
list-entry: “&7{name} &8- {uuid}”
list-unknown: “&8{uuid} &7(unknown)”

files-header: “&6=== Files for {player} ===”
file-playerdata: “&7Player Data: {status}{size}”
file-stats: “&7Stats: {status}”
file-advancements: “&7Advancements: {status}”

# Other language…
“`

X-Socials

—

### 🌟 Comprehensive Social Management

X-Socials is a professional and highly optimized solution for managing your server’s social networks. From 1.8 to 1.26.1, provide your players with a **Premium GUI Editor**, **Interactive Links**, **Automatic Rewards**, **Custom Cooldowns**, **Statistics**, and **Rich Text Formatting**. Runs natively on **Folia**, **Paper**, **Purpur**, and **Spigot**.

—

### 🚀 Premium Features

– **🪄 Auto-Config Updater** — Configs stay up-to-date automatically with every new version.
– **🖥️ Professional GUI Editor** — Create, edit and delete social networks from an intuitive in-game interface.
– **💬 Interactive Links** — Clickable URLs with hover tooltips via Bungee Chat API.
– **🎁 Reward System** — Console commands executed on first visit (UUID-based, one-time).
– **⏱️ Custom Cooldowns** — Per-social network cooldown configuration.
– **🔊 Custom Sounds** — Play different sounds for each social network.
– **📺 Custom Titles** — Show titles when players use social commands.
– **📊 Statistics System** — Track total and per-social network usage with placeholders.
– **🎨 Rich Text** — RGB colors, gradients, MiniMessage support.
– **🌍 Universal Compatibility** — Native support for Folia, Paper, Purpur, Spigot, and Bukkit.
– **🌐 Multi-Language** — Bundled support for ES, EN, PT, JA, RU.
– **📡 Broadcast System** — Automatic multi-line announcements.
– **🧩 PlaceholderAPI** — Native expansion with multiple placeholders.

—

### 💻 Commands

| Command | Description | Permission |
| :— | :— | :— |
| `/xs -gui` | Open the premium GUI editor | `xsocials.gui` |
| `/xs reload` | Reload configurations | `xsocials.admin` |
| `/xs list` | List all social networks | `xsocials.use` |
| `/xs update` | Check for updates | `xsocials.admin` |
| `/xs version` | Show plugin version | `xsocials.use` |

**Dynamic Social Commands** — `/discord`, `/youtube`, `/[your-network]`…

—

### 🔐 Permissions

| Permission | Description | Default |
|———–|————-|———|
| `xsocials.*` | Full wildcard access | ❌ |
| `xsocials.admin` | Editor, reload, gui, update | ❌ (OP) |
| `xsocials.gui` | GUI editor access | ❌ (OP) |
| `xsocials.use` | Basic player access | ✅ All players |

—

### 🧩 Placeholders

| Placeholder | Description |
| :— | :— |
| `%xsocials_total_uses%` | Total uses |
| `%xsocials__uses%` | Uses for specific network |
| `%xsocials__enabled%` | Enabled status |
| `%xsocials__link%` | Network link |
| `%xsocials__command%` | Network command |

—

X-SetWarps

—

## 📋 Description

**X-SetWarps** is a lightweight and efficient warp plugin designed for simplicity and ease of use. Create, manage, and teleport to warps with minimal configuration. It features **PlaceholderAPI** integration and a **Dual-Color engine** supporting both MiniMessage and Legacy codes.

—

## ⚡ Commands

### Administration
– **`/xsetwarp reload`** – Reloads configuration and language files.
– **`/xsetwarp update`** – Checks for plugin updates.
– **`/xsetwarp version`** – Shows the current version.

### Warping
– **`/setwarp [description]`** – Creates a warp with optional description.
– **`/warp `** – Teleports you to a warp (supports delay/cooldown).
– **`/delwarp `** – Deletes an existing warp.
– **`/warps`** – Lists all available warps.
– **`/warpinfo `** – Shows technical details about a warp.

—

## 🔐 Permissions

| Permission | Description | Default |
|————|————-|———|
| `xsetwarps.admin` | Access to `/xsetwarp` commands | OP |
| `xsetwarps.setwarp` | Access to `/setwarp` | OP |
| `xsetwarps.delwarp` | Access to `/delwarp` | OP |
| `xsetwarps.warp` | Access to `/warp` | true |
| `xsetwarps.warps` | Access to `/warps` list | true |
| `xsetwarps.warpinfo` | Access to `/warpinfo` | true |
| `xsetwarps.warp.` | Per-warp permission (if enabled) | OP |

—

## ✨ PlaceholderAPI

| Placeholder | Description |
|————-|————-|
| `%xsetwarps_total%` | Total amount of warps created |
| `%xsetwarps_last_warp%` | Last warp name used by the player |
| `%xsetwarps_cooldown_%` | Time left for specific warp cooldown |
| `%xsetwarps_warp_desc_%` | Specific warp description |
| `%xsetwarps_warp_world_%` | World name of a specific warp |

—

## 🌍 Multi-Language

Built-in support for:
🇺🇸 **English** | 🇪🇸 **Spanish** | 🇵🇹 **Portuguese** | 🇯🇵 **Japanese** | 🇷🇺 **Russian** | ✏️ **Custom**

—

## 💎 Features

– ✅ **Dual-Color Engine** – Supports MiniMessage (``) and Legacy (`&`).
– ✅ **Secure Teleport** – Delay system with move cancelation and cooldowns.
– ✅ **Folia Support** – Optimized for modern multi-threaded servers.
– ✅ **Universal Compatibility** – Supports 1.8.8 up to the latest versions.

—

X-SetSpawn

### 📝 **Description**
X-SetSpawn is a lightweight, feature-rich plugin designed to manage spawn points on your server. From simple global spawns to premium visual effects, economy integration, and proxy network support — all packed into one plugin. Compatible with Minecraft 1.8.8 to 26.1+.

### ✨ **Features**
– **Fireworks on arrival:** Launch a firework when a player teleports to spawn. Color and power configurable.
– **Combat & Falling checks:** Block `/spawn` while in combat or falling. Supports CombatLogX, PvPManager, DeluxeCombat.
– **Multi-database storage:** Save spawns to YAML (local), MySQL, MariaDB, H2 or MongoDB for cross-server sync.
– **Custom command aliases:** Define `/hub`, `/lobby` or any alias directly from `config.yml` — no need to edit `plugin.yml`.
– **Economy Integration (Vault):** Charge players to use `/spawn`. Money only deducted if the teleport completes.
– **First-Join Spawn:** Set a unique spawn point for newly joining players with `/setspawn firstjoin`.
– **Smart Respawn:** On death, respects the player’s Bed or Respawn Anchor before falling back to spawn.
– **Void-Teleport:** Automatically teleport players who fall below a configurable Y-level.
– **Post-Teleport Protection:** Temporary invulnerability after teleporting while chunks load.
– **Advanced Proxy Sync:** Dedicated lightweight plugins for Velocity and BungeeCord. Use `/setlobby` to sync your lobby server automatically.
– **Intelligent Proxy Teleport:** Automatically detects if a player is already on the target server and performs a local teleport.
– **Visual Countdown:** ActionBar, BossBar, Titles and particle effects during the delay — each individually toggleable.
– **Countdown sounds:** “Tic-Tac” click sounds each second during the teleport delay.
– **PlaceholderAPI:** Full PAPI support. Exposes `%xsetspawn_cooldown%`, `%xsetspawn_delay%`, `%xsetspawn_is_pending%`, `%xsetspawn_spawn_set%`.
– **Config auto-updater:** Detects outdated configs, creates a backup and rebuilds automatically.
– **100% Customizable:** 6 language files (EN, ES, JA, PT, RU, CUSTOM), per-world spawns, and full config control.

### 🖥️ **Compatibility**
| Software | Supported |
|—|—|
| Bukkit / Spigot / Paper / Purpur | ✅ |
| Folia | ✅ |
| BungeeCord / Velocity | ✅ |
| Minecraft | 1.8.8 → 26.1+ |

### 🛠️ **Main Commands**

**`/spawn`**
Teleports the player to the established spawn point.

**`/setspawn [x y z] [world] [yaw pitch]`**
Sets the spawn point. Use without arguments for your location, or specify coordinates (supports `~`). Console compatible.

**`/delspawn `**
Deletes a specific named spawn point if named spawns are enabled.

**`/back`**
Teleports the player back to their last location before using a spawn command.

**`/setlobby`**
Sets the lobby coordinates for the proxy network and syncs the configuration with BungeeCord/Velocity.

**`/xss [subcommand]`**
– **`help`** – Shows the help menu.
– **`reload`** – Reloads the plugin configuration.
– **`version`** – Shows the current version info.
– **`update`** – Manually check for updates.
– **`setspawn`** – Sets the spawn point (alias for /setspawn).
– **`delspawn`** – Deletes a spawn (alias for /delspawn).

### 🛡️ **Permissions**

– **`xsetspawn.spawn`** – Use `/spawn`. *(default: everyone)*
– **`xsetspawn.setspawn`** – Use `/setspawn`. *(default: op)*
– **`xsetspawn.admin`** – Admin commands and update notifications. *(default: op)*
– **`xsetspawn.reload`** – Reload the configuration. *(default: op)*
– **`xsetspawn.update`** – Check for updates. *(default: op)*
– **`xsetspawn.bypass.cooldown`** – Skip the teleport cooldown. *(default: op)*
– **`xsetspawn.bypass.delay`** – Skip the teleport delay. *(default: op)*
– **`xsetspawn.bypass.economy`** – Teleport for free. *(default: op)*

> **Tip:** Explicitly denying a node (`-xsetspawn.spawn`) will block the player even if they are OP.