feat/v1 (#7)

* Feat/v1 (#1)

* feat: remove usage of deprecated method

* feat: add javascript engine

* feat: start registry

* feat: add implementation of animation

* feat: add implementation of the animation registration from javascript

* fix: message service and first test of scripts

* feat: start crate model

* feat: start hooks for items in crates

* feat: add rewards and fix sounds

* feat: add give reward after the animation

* feat: add display name and improve exemple

* feat: start relation with zmenu

* feat: finish relation with zmenu

* feat: add encapsulation in a zmenu button

* feat: add user management

* feat: add system for manage key

Please enter the commit message for your changes. Lines starting

* feat: use PDC for physical key

* fix: imports

* fix: relocations

* feat: add placeable crates

* fix: refacto miss package

* feat: add hooks

* feat: add logging of crate opening for data

* feat: update depdendencies and use their upgrades

* feat: add open command and improve onEnable

* feat: add random algorithm manipulation systeme

* feat: improve js system for rewards

* feat: fusion js engine

* feat: better data layer

* feat: add preview for crates

* feat: (wip) reroll system

* feat: finish reroll system

* feat: add open condition system

* feat: add messages in the ressources

* feat: better message handling

* feat: add papi expansion and documentation

* feat: add javadoc

* Feat/v1 (#2)

* feat: add ci

* feat: add publish plugin

* Update Oraxen dependency version in build.gradle.kts

* feat: better placeholder condition (#3)

* Create marketplace page for plugin (#4)

* docs: add comprehensive marketplace README

- Add professional README.md with badges and structured sections
- Include installation and configuration guides
- Document commands, permissions, and features
- Add developer API documentation and build instructions
- Include project structure and support information

* docs: translate README to English

- Translate all sections from French to English
- Update description, features, and requirements
- Translate installation and configuration guides
- Update commands, permissions, and developer sections
- Translate support information and changelog

* docs: enhance README with detailed features and examples

- Add "Why Choose zCrates" section highlighting JavaScript-powered features
- Add Showcase section with placeholders for 4 demonstration GIFs
- Document reward types (COMMAND, ITEM, PERMISSION, ECONOMY, CUSTOM)
- Document opening conditions with JavaScript examples
- Add detailed animation system documentation
- Include complete configuration examples (YAML + JavaScript)
- Add custom animation example (CSGO-style)
- Add custom condition example (VIP world check)
- Expand developer section with Java and JavaScript API examples
- Add pre-built animation types documentation

* docs: fix README to reflect actual codebase implementation

- Add development status warning
- Replace "Features" with "Planned Features"
- Add "Current Status" section showing implemented vs in-development
- Remove all JavaScript-related documentation (not implemented)
- Remove fake configuration examples for non-existent features
- Update developer API section to show only implemented classes
- Simplify showcase section (remove placeholder GIFs for missing features)
- Update changelog to honestly reflect development progress
- Mark implemented features with ✅ and planned features with 🚧

This README now accurately represents the current state:
✅ Implemented: Plugin infrastructure, commands, configuration, logging, messaging
🚧 Not implemented: Rewards, conditions, animations, crate mechanics

* docs: create complete marketplace README based on develop branch

Based on actual implementation found in develop branch:

Features documented:
- 4 reward types (ITEM, ITEMS, COMMAND, COMMANDS)
- 2 condition types (PERMISSION, COOLDOWN)
- JavaScript animation system with Rhino (instant, roulette, cascade, simple)
- 3 reward algorithms (weighted, pity_system, progressive_luck)
- Virtual and physical key types
- 6 display types (BLOCK, ENTITY, MYTHIC_MOB, ITEMS_ADDER, ORAXEN, NEXO)
- Complete command system (8 commands)
- Database persistence (SQLite, MySQL, MariaDB)
- zMenu GUI integration (required)
- Full JavaScript API for custom animations and algorithms

Added sections:
- Detailed feature descriptions
- Configuration examples
- Custom animation JavaScript example
- Custom algorithm JavaScript example
- Java API usage examples
- Technology stack
- Database documentation

All information verified against actual codebase implementation.

* docs: add PLACEHOLDER condition from PlaceholderAPI hook

Add documentation for the third condition type:

PLACEHOLDER Condition:
- Supports 6 comparison types (EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN,
  GREATER_THAN_OR_EQUALS, LESS_THAN_OR_EQUALS)
- Requires PlaceholderAPI hook (hooks/PlaceholderAPI/)
- Supports both numeric and string comparisons
- Cleans numbers (removes commas and spaces) for numeric comparisons
- Falls back to string comparison for EQUALS/NOT_EQUALS if parsing fails

Updates:
- Opening Conditions: Changed from 2 to 3 condition types
- Added detailed PLACEHOLDER condition documentation with examples
- Updated example crate configuration to include PLACEHOLDER condition
- Updated requirements to clarify PlaceholderAPI is needed for PLACEHOLDER
- Updated changelog to mention 3 conditions + PlaceholderAPI integration

* docs: create promotional MARKET.md page

Create a marketplace-focused document with promotional tone:

Changes from README.md:
- Removed technical "For Developers" section (Java API, Maven, Building)
- Reduced JavaScript code examples to basics only
- Removed "Technology Stack" technical details
- Simplified PLACEHOLDER condition explanation
- Removed detailed permissions table

Added promotional content:
- "Why Choose zCrates?" section with benefits
- Call-to-action at the end
- "What Makes zCrates Special" highlights
- Simplified, benefit-focused descriptions
- Visual tables for easier reading

Focus:
- Player benefits over technical details
- Easy setup and usage
- Customization possibilities
- Professional but accessible tone

* docs: remove README.md, keep only MARKET.md for marketplace

---------

Co-authored-by: Claude <noreply@anthropic.com>

* feat: spigot compatibility

* Feat/better exemple (#5)

* fix: exemples

* feat: add zItems hook for exemples

* feat: add zItems soft depend

* fix: message

* Feat/better exemple (#6)

* fix: exemples

* feat: add zItems hook for exemples

* feat: add zItems soft depend

* fix: message

* feat: better docs in wrong branch

* feat: better img

* feat: add bStats intégration

* feat: add gif in market.md

* Delete license section from MARKET.md

Removed license section indicating private property.

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: Traqueur-dev

.github/workflows/build.yml

@@ -0,0 +1,30 @@
+name: Build Action
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    types: [ opened, synchronize, reopened ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  packages: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build and Publish zCrates
+    uses: GroupeZ-dev/actions/.github/workflows/build.yml@main
+    with:
+      project-name: "zCrates"
+      publish: true
+      project-to-publish: "api:publish"
+      discord-avatar-url: "https://groupez.dev/storage/images/337.png"
+    secrets:
+      WEBHOOK_URL: ${{ secrets.WEBHOOK_URL }}
+      MAVEN_USERNAME: ${{ secrets.MAVEN_USERNAME }}
+      MAVEN_PASSWORD: ${{ secrets.MAVEN_PASSWORD }}