📚OWO-Welcome Tutorial

🌍 Overview

Welcome to the official wiki for OWO-Welcome, a lightweight Minecraft plugin that transforms your server's join/quit experience and spices it up with a dazzling achievement system! 🎉 Built for Spigot, this plugin brings custom messages, epic sounds, stealthy staff tools, and rewarding achievements to any server—be it survival, creative, or minigames.

Perfect for server owners who want to wow their players or developers craving a tweak-friendly plugin, OWO-Welcome is your go-to for a vibrant server vibe! 🌈

Get OWO-Welcome here:

✨ Features

🎯 Core Features

• 📢 Custom Welcome Messages: Multi-line, color-coded greetings with Minecraft codes (e.g., &a).

• 🎵 Epic Join Sounds: Play sounds like ENTITY_PLAYER_LEVELUP—global or just for the player.

• 📺 Titles & Subtitles: Flash bold, colorful titles when players join.

• 🤫 Join/Quit Silence: Hide join/quit broadcasts for sneaky moves.

• 👻 Staff Vanish Mode: Let staff join invisibly or toggle it anytime.

• 🎓 Permission-Based Ranks: Unique join vibes based on player perms.

• 🏆 Achievement System: Reward entity kills with custom goals and flair.

• 📊 bStats Integration: Lightweight stats tracking (ID: xx).

• 💾 Data Persistence: Achievements saved in JSON for restarts.

🛠️ How It Works

OWO-Welcome hooks into join/quit and kill events to bring the magic. Messages and sounds fire on join, while achievements tick up with every kill—fully customizable via YAML and backed by JSON storage! 🔧

🛠️ Installation

📋 Step-by-Step Guide

1. ⬇️ Download: Grab owo-welcome.jar from Spigot, PolyMart, or BuiltByBit.

2. 📂 Install: Drop the JAR into your plugins folder.

3. 🚀 Start Server: Boot up to generate config.yml and achievements.yml.

4. ✏️ Configure: Tweak the files to set your style.

5. 🔄 Apply Changes: Restart or use /owo reload to roll it out.

💡 Tip: Works best on Spigot 1.13+!

📜 Commands & Permissions

🎮 Commands

Command	Description	Permission
/owo reload	Reloads configs and achievements.	owo.reload
/owo vanish	Toggles player invisibility.	owo.vanish

🔑 Permissions

• 🔓 owo.reload: Unlock the reload command.

• 👻 owo.vanish: Toggle vanish mode.

• 👤 owo.default: Default rank (customizable).

• 👑 owo.owner: Example custom rank.

⚙️ Configuration

OWO-Welcome shines with two config files: config.yml for welcomes and achievements.yml for epic goals! 🌟

📝 config.yml

🌈 Overview

Controls welcome messages, sounds, and vanish magic.

📄 Example

default:
  message-welcome: |
    &0░&0░&8░&8░&7░&7░&f░&f░&7░&7░&8░&8░&0░&0░
    &0          &c&lYOUR SERVER
    &f
    &fWelcome &7%player% &fto the server
    &fBelow are our social media links
    &f
    &f&9&lDiscord &7https://discord.gg/
    &f&5&lTwitch &6https://twitch.tv/
    &0
    &0░&0░&8░&8░&7░&7░&f░&f░&7░&7░&8░&8░&0░&0░
  permission-toggle: false
  permission: owo.default
  sound-join: ENTITY_PLAYER_LEVELUP
  sound-toggle: true
  sound-global: false
  join-silence: false
  staff-vanish: false
  message-join: "&a%player% &fhas joined the server."
  message-quit: "&c%player% &fhas left the server."
  title-welcome: "&a&lWELCOME"
  subtitle-welcome: "&fEnjoy your stay on the server!"
  toggle-messages: true         

🔍 Fields

Field	Description	Default
message-welcome	Multi-line join message for the player.	See example
message-join	Broadcast on join.	&a%player% &fhas joined the server.
message-quit	Broadcast on quit.	&c%player% &fhas left the server.
sound-join	Sound on join.	ENTITY_PLAYER_LEVELUP
toggle-messages	Enable/disable custom messages.	true

🏆 achievements.yml

🎖️ Overview

Defines custom achievements for entity kills.

📄 Example

first_hostile_kill:
  type: ENTITY_KILL
  entity_type: ZOMBIE
  total_require: 1
  description: |
    &8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░
    &0          &a&lAchievement Unlocked
    &f
    &f&7%player% &fCongratulations on earning the achievement
    &f&cFirst Kill &fWell done for your hard work!
    &f
    &f&7This achievement is earned when you kill
    &f&7your first hostile entity.
    &0
    &8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░&8░
  sound: ENTITY_PLAYER_LEVELUP
            

🔍 Fields

Field	Description	Example
type	Event type for the achievement.	ENTITY_KILL
entity_type	Target entity.	ZOMBIE
total_require	Kills needed.	1
description	Completion message.	See example
sound	Sound on completion.	ENTITY_PLAYER_LEVELUP

💬 Support

🌐 Get Help

Got questions or ideas? Join our Discord: https://discord.gg/Y67xJxQHVK.

OWO-Welcome is crafted with 💜 by SrCodex/SrNemesis. Your feedback fuels the fun!