====== Server Rewards (Custom) ======

**Custom Plugin**

===== Overview =====

Server Rewards creates a roulette wheel gambling system where players can use keys earned through playtime to win server privileges, command access, limit increases, and cosmetic features. The plugin encourages regular play while providing worthwhile rewards that enhance the gameplay experience.

----

===== Main Commands =====

<code>
/sr      - View all possible rewards for each tier and their win chances
/namecolor [color name/hex]      - Change your username color (rare reward)
/namecolor gradient [color1] [color2]      - Apply gradient colors to name (rare reward)
</code>

----

===== Roulette System =====

**How to Use:**
  * Obtain keys through the [[plugins:rewardslite|RewardsLite]] plugin
  * Find the roulette wheel activator block at **/warp Gamble**
  * Right click the activator while holding a roulette key
  * Watch the wheel spin and receive your reward
  * Different key tiers have different reward pools

**Key Tiers and Sources:**
  * **Bronze Keys** - Every 2 hours of active playtime
  * **Silver Keys** - Every 6 hours of active playtime  
  * **Gold Keys** - Every 12 hours of active playtime
  * **Head Database Keys** - Special keys for HeadDatabase category permissions

----

===== Reward Categories =====

**Command Access Rewards:**
  * `/craft` - Open crafting table anywhere
  * `/echest` - Access ender chest remotely
  * `/grindstone` - Use grindstone anywhere
  * Other convenience commands for enhanced gameplay

**Limit Increases:**
  * **Home Limits** - Increase your maximum number of homes
  * **Shulker Tracker Slots** - More [[plugins:shulkgps|ShulkGPS]] tracking capacity
  * **Warp Limits** - Create more [[plugins:playerwarps|PlayerWarps]]
  * **Claim Blocks** - Additional [[plugins:griefprevention|GriefPrevention]] land protection

**Currency Rewards:**
  * **Cash Prizes** - Direct money deposits to your account
  * **Variable amounts** - Different tiers offer different amounts
  * **Economy boost** - Helps fund shops, warps, and other purchases

**Cosmetic Features:**
  * **Head Database Access** - Unlock decorative head categories
  * **Username Colors** - Customize your display name appearance
  * **Gradient Names** - Advanced color effects for your username

----

===== Name Color System =====

**Basic Name Colors:**
  * **Silver Tier Reward** - Unlocks basic name color changing
  * Use color names (red, blue, green) or hex codes (#FF0000)
  * Changes your display name color in chat and player lists
  * Replaces traditional nickname system with color-only customization

**Gradient Names:**
  * **Gold Tier Reward** - Unlocks advanced gradient coloring
  * Specify two colors to create a smooth transition effect
  * Creates unique, eye-catching name displays
  * Premium cosmetic feature for dedicated players

**Usage Examples:**
<code>
/namecolor red      - Makes your name red
/namecolor #00FF00      - Makes your name bright green
/namecolor gradient blue red      - Creates blue-to-red gradient
/namecolor gradient #FF0000 #0000FF      - Custom hex gradient
</code>

----

===== Reward Transparency =====

**Viewing Rewards:**
  * Use `/sr` to see complete reward lists for each key tier
  * **Probability display** - Shows exact chances for each reward
  * **Tier comparison** - Compare what different keys can offer

**Fair Gambling:**
  * **Transparent odds** - All chances clearly displayed
  * **No hidden mechanics** - What you see is what you get
  * **Balanced rewards** - Higher tiers offer better prizes
  * **Skill-based earning** - Keys can only be earned through active playtime

----

===== Tips =====

  * Check `/sr` before using keys to understand possible rewards
  * Keys are refunded if you win a reward you already have (like /craft)
  * Head database keys are separate from playtime keys

===== Related Pages =====

  * [[:plugins|All Server Plugins]]
  * [[:plugins:rewardslite|RewardsLite]] (how to earn keys)
  * [[:plugins:shulkgps|ShulkGPS]] (tracker slot upgrades)
  * [[:plugins:playerwarps|PlayerWarps]] (warp limit increases)
  * [[:plugins:griefprevention|GriefPrevention]] (claim block rewards)

---

//Server Rewards transforms playtime into exciting prizes, giving dedicated players powerful tools and unique customization options.//