ENGRAVING:

(WARNING: THIS PLUGIN MAKE with CHATGPT help, but the idea all OWN. Plz before download and use this plugin, consider this)

Introduction
Engraving is a progression-based RPG plugin for Paper Minecraft servers. It introduces item enhancement, elemental damage, passive engravings, active abilities, combo chains, and advanced combat mechanics.

The entire system begins with a special item called the Upgrade Core.

OP Commands:
/engraving upgrade
# force upgrade
/engraving skill [skillname]
# test the active-effects design.
/engraving givecore
# give an upgrade core.

PERMISSIONS:
Commands only use ops, or if somebody have this perm:
engraving.menu


Upgrade Core

Upgrade Cores are the foundation of the progression system.

Players obtain Upgrade Cores from configurable blocks in the world. Every block, drop chance, and reward can be customized through the configuration files. Upgrade Cores are used inside an Anvil to enhance weapons, armor, and tools.

Enhancement Process

Place:

• The item you want to enhance in the left slot.
• An Upgrade Core in the right slot.

The plugin automatically attempts an enhancement when the player takes the result item. Enhancement levels increase the item's power and unlock additional systems.



Elemental Damage Selection

The first successful enhancement (+1) unlocks the Elemental Damage Selection menu. The player may select one elemental damage type for the item.

Only one elemental damage type can exist on an item.

After the first selection, the menu never appears again unless the item falls back to +0 through enhancement failure.

Every future successful enhancement increases the elemental multiplier.

Example:

Fire Damage: 4.01-1.05 x1 5s
becomes:

Fire Damage: 4.01-1.05 x5 5s
at enhancement level +5.

The selected elemental damage type is always visible in the item lo


Elemental Damage Types
Fire Damage

Fire Damage: 4.01-1.05
Features:

• Orange particles
• Damage over time
• Damage gradually weakens
• Stackable

Water Damage
Water Damage: 1.05-4.01
Features:

• Light blue particles
• Damage over time
• Damage gradually increases
• Stackable

Kinetic Damage
Kinetic Damage: 0.05-0.12
Features:

• Gray particles
• Instant damage
• Ignores armor

Electric Damage
Electric Damage: 0.15
Features:

• Yellow particles
• Damage over time
• Applies blindness

Wave Damage
Wave Damage: 0.5-1.05
Features:

• Green particles
• Distance-based damage
• Instant damage

Star Damage

Star Damage: 1.05-1.35
Features:

• Purple particles
• Damages armor durability
• Multiple damage ticks

Engraving
At enhancement level +6 the item unlocks:

[ENGRAVING]
This allows the item to receive Passive Abilities. Passive abilities are selected through the progression system and permanently stored inside the item.

Passive abilities only function when the item is:

• Equipped
• Worn as armor
• Held inside the hotbar

Items stored inside normal inventory slots provide no passive bonuses.

Passive Ability Examples

• Haste
• Speed
• Resistance
• Strength
• Regeneration
• Health Boost

Abilities can be upgraded multiple times.

Example:

[HASTE]
becomes:

[HASTE 2]
then:

[HASTE 3]
and continues scaling according to configuration.


Special Engraving
At enhancement level +7 the item unlocks:

[SPECIAL ENGRAVING]
This grants access to Active Abilities.

Active abilities can be manually activated using:

• Right-Click
• Left-Click

depending on the skill configuration.


Active Abilities
Active abilities are fully configurable.

Example:

skill_name: "Cutter"
skill_reference: "cutter"
activation: "rmc"
cooldown: 10
Skills support:

• Custom particles
• Custom sounds
• Damage values
• Cooldowns
• Negative effects
• Range settings
• Target lock systems
• Combo compatibility

Skill Shapes
Skills can create different particle formations.

Supported shapes:

• Line
• Circle
• Sphere

Additional targeting systems:

• Laser
• Starfall
• Airtargeter

Scatter Skills
Scatter mode converts an active ability into a projectile-based attack.

Supported projectile types:

• Snowball
• Fireball
• Firework

Features:

• Multiple projectiles
• Armor penetration
• Recoil
• Mining capability
• Tree destruction

Example:

scatter: true
scatter_shot: 10
damage: 100

Elemental Damage Stacks
Elemental damage uses a stack-based combat system. Every successful hit can add a new stack. The maximum number of stacks depends on the enhancement level of the item. Higher enhancement levels allow more simultaneous stacks.

Configuration:

special_damage_cooldown: 5
special_damage_overheat_cooldown: 10

Stack Behavior
When a stack is applied:

1. The elemental particle leaves the weapon.
2. A particle sphere appears around the target.
3. The sphere grows according to the damage effect.
4. The elemental damage is applied.

If the weapon still has available stacks, the elemental particle remains visible on the weapon.

When all stacks have been consumed, the weapon enters cooldown.

Overheat System
When maximum stacks are reached, the weapon enters Overheat mode.

During Overheat:

• No new stacks can be applied.
• Special damage becomes unavailable.
• Elemental particles disappear.

After the configured Overheat cooldown expires, the system resets and becomes available again.

S-Rank Enhancement
Items containing Active Abilities may receive a final upgrade.

This special enhancement creates:

Upgrade: S
[COMBO CHAIN]
depending on language settings.

Once upgraded to S Rank:

• No additional passive abilities may be added.
• No additional active abilities may be added.
• Enchanting is disabled.
• The item becomes a finalized build.

Combo Chain System
The Combo Chain system allows multiple S Rank items to work together. Only items placed inside configured hotbar slots participate in Combo Chains.

Normal inventory and Armor, slots do not activate Combo Chains.

Main Combo Slot
The main weapon must be placed inside one of the configured Main Combo Slots.

Example:

main_combo_slot: [5]
Only slot 5 may start a Combo Chain.

Side Combo Slots
Additional S Rank items can be placed inside Side Combo Slots.

Example:

side_combo_slot: [6,7,8,9]
These items become linked to the main weapon.

Combo Execution
When the player activates a Combo Chain:

1. Main weapon skill activates.
2. Delay begins.
3. Side item skill activates.
4. Delay begins.
5. Next side item activates.

This continues until all linked skills have executed.

Combo skills ignore normal skill cooldowns and instead use dedicated Combo cooldown settings.

combo:
enabled: true
cooldown: 10
active_delay: 30

Visual Systems
The plugin contains extensive particle customization.

Features:

• Hand-positioned particles
• Element-specific colors
• Level-based scaling
• Stack visualizations
• Target spheres
• Expanding damage rings

Particle behavior can scale with enhancement levels.

particle_levels: true
particle_count_lvls: "1,1.5,2,2.5,3,3.5,4"
particle_size_lvls: "1,1.05,1.1,1.15,1.2,1.25,1.3"

WorldGuard Integration
Active abilities can be blocked inside protected regions. Players receive an Action Bar warning when attempting to use restricted abilities.

Localization
Supported languages:

• English
• Hungarian

Bugs?

If you found any bug, problem, plz write me in discussion. And i know, i used chatgpt for makeing codes.. Im not programmer, but i have too much ideas. Plz if u found any bug, just write the problems. I can't test alone too good, so i put this plugin on public. I hope somebody love this type plugin . PIECE!