CursorCs v1.9.9 Performance

CursorCS – Update Notes

Changes applied

• Performance improvements
  Better performance is expected in cursor movement and menu interactions.
  Cursor menus should now feel smoother and more consistent overall.
  
• Improved Folia support
  Folia compatibility has been refined, especially for:
  • tasks and schedulers
  • holograms
  • FancyNPC entities
  • camera sessions
• FancyNPC stability improvements
  Better handling of NPC holograms, reducing inconsistencies during runtime updates.
  
• Placeholder optimization
  Realtime placeholder processing was optimized to reduce unnecessary work in the main cursor loop.
  
• New sensitivity control
  Players can now adjust cursor sensitivity individually.
  
  
  Code:

  /cursor sensitivity <amount>
  /cursor sensitivity reset

• New command alias
  Added /cursor end as an alias for /cursor stop.
  
• Improved live reload behavior
  Better handling when reloading:
  • holograms
  • clickable areas
  • groups
  • NPC configurations
• Bedrock improvements
  Improved cursor handling and correction tools for Bedrock compatibility.
  
• Scheduling and internal cleanup
  Safer internal scheduling logic for better stability across Paper and Folia environments.
  
• ItemDisplay support improvements
  Improved support for ItemDisplay holograms when used in clickable area actions.

Solved FancyNpcs Compatability

Changes applied

• Folia Compatibility
  CursorCS now fully supports Folia while maintaining full compatibility with Paper.
  
  This improves stability and performance on modern servers without requiring any additional configuration.
  
• Velocity / BungeeCord Server Switch
  Players can now be sent to other proxy servers directly from CursorCS.
  
  This feature works in:
  • commands
  • GUI buttons (holograms)
  
  Example – direct command:
  
  
  Code:

  commands:
    - "server:lobby"

  
  Example – GUI button:
  
  
  Code:

  holograms:
    lobby_button:
      text: "&a[ Go to Lobby ]"
      onClick:
        - "server:lobby"
        - "message:&7Sending you to the lobby..."

  
  Example – combined actions:
  
  
  Code:

  onClick:
    - "sound:entity.experience_orb.pickup"
    - "server:survival"

(If you found any bug in folia let me know)

CursorCS - Update Notes

Changes applied

• FOV Fix
  Added a shader pack bundle that can be merged into your server resource pack.
  This allows the menu FOV to be standardized automatically when players enter cursor start.
  
  Recommended workflow:
  • Design menus around 110 FOV for best visual consistency.
  • If the shader is already active during development, alignment will naturally match in-game.

• Improved hover detection for overlapping clickable areas.
  Hover now prioritizes areas that define on_hover / on_unhover, avoiding incorrect blocking between overlapping regions.
  
• Added multi-area hover support.
  Multiple valid areas can now behave consistently instead of one incorrectly overriding the others.
  
• Improved hover reset and unhover cleanup.
  All active hovered areas are now properly cleared, preventing stuck states.
  
• Fixed relative_to behavior with hotbar and moving holograms.
  Clickable areas now follow holograms more reliably when using scroll or transform-based interactions.
  This is especially useful for scroll-based menus and dynamic UI elements.
  
• Fixed default menu sound behavior.
  Default menu sounds now only play when the base/default menu is opened.
  They no longer replay when switching groups or rebuilding holograms in the same session.
  
• Adjusted /cursor start <group> behavior.
  The default menu sound is no longer triggered before opening the selected group.
  
• Fixed exclude handling in open_animation.
  Excluded holograms no longer receive initial animation frames.
  
• Added proper reset handling for excluded holograms.
  Excluded elements are now restored to their base configuration instead of inheriting unintended transforms.
  This is particularly important for FancyNPC.
  
• Improved open_animation consistency.
  Internal fixes were applied for both normal groups and activable groups to avoid incorrect references and broken animation setups.
  
  
  
• Added test servers in multiple regions.
  Three public test servers are now available:
  • USA
  • Europe
  • Asia

• Added license validation for official builds to improve product security and distribution control.
• Public API is now available for developers and addon creators:
  https://github.com/nxxxzsorteo-cell/cursorcs-api
• chimage addon is now distributed for free through the Discord community.

CursorCS v1.9.5

Changes applied
Note: There were about 300 optimization-related changes implemented, so I won't list them all here and will only include the features

• Added on_click action lists for clickable areas.
  Clickable areas can now execute multiple actions directly on click.
  
  
  Code:

  play_button:
    min_x: -0.30
    max_x: 0.30
    min_y: -0.10
    max_y: 0.15
    on_click:
      - type: "scale"
        hologram: "play_button"
        scale: 0.18
        duration: 0.12
        interpolation: "ease_out"

• Clickable areas can now trigger hologram animations.
  
  Supported:
  start_animation, start_text_animation, start_spawn_animation.
  
  
  Code:

  open_panel:
    on_click:
      - type: "start_animation"
        hologram: "panel_title"
        mode: "spawn"

• Added mode: "precise" for transform actions.
  Allows stable animations from current state to target.
  
  Supported in:
  move, scale, rotate, combined.
  
• Added typewriter text animation.
  Automatically generates frames.
  
  
  Code:

  english_text:
    text: ""
    animation:
      enabled: true
      autostart: false
      type: "one"
      keep_last_frame: true
      typewriter:
        text: "English"
        alignment: "RIGHT"
        interval_ticks: 2

• Added sound actions in clickable areas.
  Works in:
  on_hover, on_unhover, on_click, hotbar.
  
  
  Code:

  on_hover:
    - type: "sound"
      sound: "ui.button.click"
      volume: 0.8
      pitch: 1.1

• Added menu open sound support.
  
  
  Code:

  group: "shop_menu"
  alias: "shop"
  sound: "minecraft:ui.button.click"

• Added menu aliases.
  
  
  Code:

  group: "shop_menu"
  alias: "shop"

  
  Allows:
  • /shop
  • /cursor start shop
• Improved apply_group behavior with required_group support.
  
  
  Code:

  conditions:
    required_group: "default"

• Added open_url action for clickable areas.
  
  
  Code:

  on_click:
    - type: "open_url"
      url: "https://example.com/store"
      link_text: "§b§nOpen store"

• Added menu open_animation presets.
  
  Supported presets:
  slide_from_right, slide_from_left, slide_from_top, slide_from_bottom,
  scale_in, pop_in, spin_in_right, spin_in_left.
  
  
  Code:

  open_animation:
    preset: "slide_from_right"
    duration: 0.35
    stagger_delay: 0.04

• Added preset micro animations for UI effects.
  
  
  Code:

  on_hover:
    - type: "preset_animation"
      hologram: "play_button"
      preset: "pulse"
      duration: 0.15

  
  Supported presets include:
  pulse, bounce, wiggle, shake, error_shake, confirm_pop, jelly, etc.
  
• Improved hotbar scrollbar system.
  
  
  Code:

  hotbar:
    enabled: true
    on_step_forward:
      - type: "move"
        mode: "cumulative"
        offset_y: -0.3

• Extra quality-of-life improvements:
  • required_group: "default" support
  • relative_to for clickable areas
  • menu-level sound, alias, open_animation
  • apply_group improvements for UI state switching

Just small fixes to clickable areas and change_text part.

CursorCS v1.9 HOTFIX

Changes applied

• Added personal FOV support with /cursor fov <value>.
  Each player can now set their own hologram distance based on their own FOV.
  This only affects that player, not everyone else.
  
  
  Code:

  /cursor fov 110
  /cursor fov 90

• Added /cursor fov reset.
  This removes the personal FOV override and returns the player to the normal global hologram distance.
  
  
  Code:

  /cursor fov reset

• Added persistent personal FOV storage.
  Player FOV overrides are now saved and restored automatically, so they persist after server restarts.
  
• Added clickable area scaling support for personal FOV.
  Clickable areas now scale with the player’s hologram distance so hover/click zones stay aligned.
  
• Improved clickable area scaling math for FOV changes.
  Horizontal and vertical bounds are now handled separately for better accuracy.
  
• Important notice
  This update may affect existing clickable areas.
  Older clickable areas may feel slightly offset depending on layout and FOV.
  
• Recommended action
  • Review your clickable areas after updating.
  • Re-adjust or recreate any misaligned buttons.
• What to test
  • normal hover alignment
  • normal click alignment
  • clickable areas with /cursor fov
  • clickable areas inside scrollbars
  • clickable areas using relative_to
• Suggested workflow
  • set your usual FOV with /cursor fov <value>
  • test your menus and buttons
  • re-tune any clickable areas if needed