EmakiStrengthen | Star-Progression & Branching

EmakiStrengthen provides two independent enhancement systems for equipment: star strengthening and branch strengthening. Star strengthening is the classic incremental upgrade with diminishing success rates creating risk-reward tension. Branch strengthening offers tree-shaped route selection, letting players customize their equipment growth direction based on playstyle.

Core Features

Star Strengthening System

Classic equipment enhancement gameplay where each attempt increases one star level with diminishing success rates:

Default Success Rate Curve:

| Target Star | Base Success Rate |
| ----------- | ----------------- |
| +1 | 100% |
| +2 | 100% |
| +3 | 95% |
| +4 | 85% |
| +5 | 75% |
| +6 | 60% |
| +7 | 45% |
| +8 | 32% |
| +9 | 22% |
| +10 | 14% |
| +11 | 8% |
| +12 | 4% |

Each recipe can override global rates with its own curve. Actual success rate = base rate + pity bonus, capped at success_chance_cap (default 90%).

Failure Penalties:

• Keep — Star level unchanged, pity accumulates
• Downgrade — Star level drops by 1, pity accumulates
• Shatter — Equipment is damaged (requires repair)

Economy Cost:

• Supports Vault economy system
• Cost formula supports {base_cost} and {star} variables
• Example: {base_cost} * {star} means cost scales linearly with star level

Branch Strengthening System

Tree-shaped route selection allowing the same equipment to grow in completely different directions:

Branch Tree Structure:

• branch_id — Branch identifier (root node uses "root")
• display_name — Branch display name for GUI selection
• fork_after_star — Star level after which the fork choice appears (-1 = no fork)
• stars — Star stage definitions within this branch
• children — Child branch list

Fork Mechanism:

When a player completes the specified star level, the system presents a branch selection GUI. The player must choose a route to continue. Example:

• root (★1-4) → fork_after_star: 4 → Choose Sharp/Heavy route
• sharp (★5-7) → fork_after_star: 7 → Choose Lethal/Swift route

Path Recording:

Selected branch paths are stored in item PDC (e.g., "sharp/lethal") for:

• Determining subsequent star configurations
• Visual display in GUI showing the chosen route
• Correct attribute rebuilding on refresh

Multi-Layer Nesting:

Branches can nest infinitely — a branch can fork again internally. This enables complex skill-tree-style growth routes, such as:

• Base route → Physical/Magic fork
• Physical route → Crit/Heavy/Penetration fork
• Each ultimate route unlocks a unique skill

Pity Compensation (Forging Marks)

The Temper system ensures every failure contributes toward eventual success:

Accumulation Rules:

• Each failed enhancement increases temper level by 1
• On success, temper resets to 0
• Temper has a maximum level (max_temper, default 4)

Compensation Formula:

• Each temper level provides fixed success rate bonus (temper_chance_bonus_per_level, default 5%)
• Actual rate = base rate + (temper level × bonus per level)
• Final rate capped at success_chance_cap (default 90%)

Example Calculations:

• +8 base rate 32%, temper 3: actual = 32% + 3×5% = 47%
• +10 base rate 14%, temper 4 (max): actual = 14% + 4×5% = 34%

Temper Boost Materials:

Special materials with temper_boost can provide extra temper levels when placed in the GUI, adding strategic depth to high-star attempts.

Protection Materials

Safety nets for high-risk enhancement attempts:

Anti-Downgrade Materials:

• Materials with protection: true
• Consumed on failure to prevent star loss
• Not consumed on success
• Amount set to -1 means detection-only (not consumed)

Anti-Shatter Materials:

• Prevent equipment destruction on high-star failures
• Shattered equipment requires additional repair processes

Usage Strategy:

• Low stars (+1 to +5): High success rates, protection usually unnecessary
• Mid stars (+6 to +8): Worth using anti-downgrade materials
• High stars (+9+): Strongly recommended to use protection

Name/Lore Action System

Six action types for modifying equipment appearance on successful enhancement:

| Action Type | Description | Example Use |
| ---------------- | ---------------------------------------- | --------------------------------- |
| append_suffix | Append text to end of item name | Add [+5] star marker |
| prepend_prefix | Prepend text to beginning of item name | Add route marker |
| prepend | Insert lines at top of lore | Show enhancement level and temper |
| append | Append lines at bottom of lore | First-time attribute addition |
| insert_below | Insert lines below a matched anchor line | Insert new attributes at position |
| replace_line | Replace the entire matched anchor line | Update existing attribute values |

Lore Operation Strategy:

• ★1 uses append to add attribute lines for the first time
• ★2+ uses replace_line with anchor matching to update existing values
• Milestone stars use append to add new attribute lines
• This ensures each attribute always has exactly one lore line regardless of star level

All modifications built on CoreLib's Ledger system, fully reversible.

Expression Variables

Attribute values dynamically calculated with {star} as the core variable:

Available Variables:

• {star} — Current star level
• {temper} / {max_temper} — Current/max temper level
• {temper_color} — Auto-colored code based on temper level
• {base_cost} — Economy base cost

Dynamic Calculation:

• Cost formula: {base_cost} * {star} → cost increases with star level
• Attributes can be defined independently per star or use accumulated values

Milestone Broadcasts

Server-wide announcements when reaching specific star levels:

Local Broadcast:

• Sent to nearby players within configured radius (default 48 blocks)
• Default trigger at +8
• Suitable for mid-tier achievement notifications

Global Broadcast:

• Sent to all online players
• Default triggers at +10 and +12 (max star)
• Suitable for major achievement celebrations

Custom Format:

• Messages support MiniMessage format
• Supports {player}, {star}, {show_item} placeholders
• {show_item} displays item hover tooltip in chat

Effect System

Each star level can provide multiple effect types:

| Effect Type | Description |
| -------------- | ------------------------------------------------------------------------ |
| variables | Expression engine variables for lore rendering and attribute calculation |
| ea_attribute | EmakiAttribute PDC attributes (explicit override of accumulated values) |
| es_skill | EmakiSkills skill binding, unlocked at specific star levels |
| lore_action | Item lore modifications |
| name_action | Item name modifications |

Milestone Effects:

• Specific stars can be marked as milestones (with name field)
• Milestone stars typically unlock new attribute types or skills
• Example: +5 unlocks crit rate, +8 unlocks damage bonus, +12 unlocks ultimate skill

Commands

| Command | Description | Permission |
| ----------------------------------------- | -------------------------------------------- | ------------------------ |
| /es help | Display help information | emakistrengthen.use |
| /es open | Open strengthening interface | emakistrengthen.use |
| /es reload | Reload all configuration files | emakistrengthen.reload |
| /es inspect [player] | View held item's enhancement state | emakistrengthen.use |
| /es refresh [player] | Refresh player inventory enhancement layers | emakistrengthen.admin |
| /es setstar <star> [recipe] | Directly set main-hand item star level | emakistrengthen.admin |
| /es clearstate | Remove enhancement layer from main-hand item | emakistrengthen.admin |
| /es clearcrack | Clear main-hand item temper | emakistrengthen.admin |
| /es givecatalyst <id> [amount] [player] | Give enhancement materials | emakistrengthen.admin |

Command alias: /estrengthen

Permissions

| Permission Node | Description | Default |
| ------------------------ | ------------------------ | ----------- |
| emakistrengthen.use | Basic enhancement access | All players |
| emakistrengthen.reload | Reload configuration | OP |
| emakistrengthen.admin | Full admin access | OP |

PAPI Placeholders

Prefix: %emakistrengthen_<placeholder>%

All placeholders read from the player's main-hand item:

| Placeholder | Description |
| ------------------------ | --------------------------------------------- |
| mainhand_star | Current star level |
| mainhand_temper | Current temper level |
| mainhand_recipe | Matched recipe ID |
| mainhand_eligible | Whether the item can be enhanced (true/false) |
| mainhand_success_count | Cumulative success count |
| mainhand_failure_count | Cumulative failure count |
| mainhand_max_star | Recipe's maximum star level |
| mainhand_success_rate | Next enhancement success rate |
| mainhand_crack_level | Item's crack level |

Ideal Server Types

EmakiStrengthen is particularly well-suited for:

• RPG/MMORPG servers — Star enhancement provides continuous growth, branching adds build diversity
• PVP servers — High-star gear provides competitive advantage, enhancement risk adds excitement
• Long-term survival servers — Long-term goal-driven, pity compensation prevents excessive frustration
• Dungeon servers — Dungeon drops provide protection materials, creating gear progression loops

Not recommended for pure vanilla survival or servers that don't want gear power gaps.

Requirements

| Item | Requirement |
| ----------------- | ------------------------------------------- |
| Server | Spigot 1.21+ |
| Java | 21+ |
| Hard Dependencies | EmakiCoreLib |
| Soft Dependencies | EmakiAttribute, EmakiSkills, PlaceholderAPI |

View Full Wiki Documentation | Join Discord Community | QQ Group