For the complete documentation index, see llms.txt. This page is also available as Markdown.

๐Ÿช“cDev Axethrowing

Introduction

CDEV Axe Throwing โ€” WATL-inspired hatchet throws with strength timing, spinning axe flight, tournaments, ELO & badges, and multi-framework support for FiveM.

Place a physical target on a wall, throw with an oscillating power meter, compete in hosted tournaments with configurable rules (rings, killshots, divisions), and climb the leaderboard. Supports QBox, QBCore, ESX Legacy, oxmysql, and multiple inventories / targets / notify backends.

Purchase the Script

Showcase

Video soon

Features

Features List
  • ๐Ÿช“ High-quality streamed props โ€” Custom target board and throwing hatchet models registered via .ytyp / stream/props (tunable attach offsets, stick-in-board visuals, flight spin).

  • ๐ŸŽฏ WATL-style scoring (hatchet ruleset) โ€” Five rings 1โ€“5 from outside to center, plus killshot (blue) zones worth 8 when called before the throw โ€” host selects rule presets when creating a tournament; solo practice uses server defaults.

  • ๐Ÿ Physical lanes โ€” Players place a target on a wall using the axe_throwing_target item (configurable name) or admins use /axethrowing place. Pickup / interaction respects DrawText or eye-target modes.

  • โšก Strength meter & spinning flight โ€” Oscillating power bar; lock strength with Space, then the throw animation runs and the axe flies with configurable arc, spin, and duration (visual); server-side scoring validates hits.

  • ๐ŸŽฎ Tournament lobby & browser โ€” Host configures prize pool, paid ranks, max players, division (Rec / Amateur / Pro with rating gates), throw mode (e.g. arcade vs realistic), killshot limits, aim sway preset, and more. Others join from the tournament browser; pre-start lobby shows players, rules, and readiness.

  • ๐Ÿ† ELO rating & badge system โ€” Competitive rating based on an ELO-style update with configurable K-factor and placement multipliers (1st / 2nd / 3rd / others). Ratings are clamped between min and max. Includes:

    • ๐ŸŽ– Rank badges tied to rating thresholds (labels & colors configured in AxeThrowingConfig.Rating.Badges)

    • ๐ŸŽจ Badge colors in lobby, HUD, leaderboard, and end-of-tournament UI

    • ๐Ÿ“Š Rating & badge visible in match flow and standings

    • โš™๏ธ Configurable default rating, K-factor, limits, and badge tiers

  • ๐Ÿ”Œ Multi-framework compatibility โ€” Supports QBox (qbx_core), QBCore, and ESX Legacy with automatic detection (override in Bridge.Framework). Integrates with ox_inventory, qb-inventory, and qs-inventory, plus ox_target / qb-target and ox_lib / framework notifications โ€” all configurable with fallbacks.

  • ๐ŸŽฏ Flexible interaction modes โ€” Configurable interaction with each placed board:

    • DrawText โ€” Floating 3D text + key (e.g. [E] Axe Throwing, [G] pickup)

    • Target โ€” ox_target or qb-target with custom labels, icons, distances, sync radius, and rescan intervals for performance

  • ๐Ÿ“ Fault line (throw line) โ€” Optional on-ground fault line during matches (valid / invalid side), colors & stand zone tunable; can follow tournament rules or always-on depending on config.

  • ๐ŸŽ› Realistic throw mode (optional rules) โ€” When the host selects realistic rules, ideal power shifts with distance to the board; short throws, loose axe, and bounce tuning available in config.

  • ๐ŸŽจ Profile-ready UI flow โ€” Lobby and tournament UIs show player names, ratings, badges, and match settings so players know divisions and stakes before start.

  • ๐ŸŽจ UI themes โ€” Server owners choose default, cdev (dark + blue), or custom in public/shared/themes.json (AxeThrowingConfig.Theme). The custom block can list documentation strings per token until replaced with real CSS values.

  • ๐Ÿ›  Admin tools โ€” /axethrowing admin (ACE: cdev_axethrowing.admin) โ€” list placed lanes, teleport, delete single or bulk history where supported; /axethrowing delete removes the closest lane; /axethrowing place places without the item.

  • ๐Ÿ“Š Leaderboard & history โ€” /axethrowing leaderboard (aliases: ranking, lb) opens the leaderboard; tournament results and stats persist via oxmysql (cdev_axethrowing_players, cdev_axethrowing_tournaments).

  • ๐Ÿช“ Economy-friendly hatchet item โ€” Optional axe_throwing_hatchet requirement before throws (Item.Hatchet.requiredToThrow) for servers that want item-gated gameplay.

Installation Guide & Others

โš™๏ธInstallation GuideConfigurationsCommandsExportsIntegrationsFAQs

Last updated