📚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

⬇️ Download: Grab owo-welcome.jar from Spigot, PolyMart, or BuiltByBit.
📂 Install: Drop the JAR into your plugins folder.
🚀 Start Server: Boot up to generate config.yml and achievements.yml.
✏️ Configure: Tweak the files to set your style.
🔄 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!

Last updated 5 months ago