Skip to content

Instantly share code, notes, and snippets.

@KageDesu

KageDesu/aabsz_new_skill_panel_guide.md

Created January 27, 2026 13:06
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save KageDesu/c687dd264d00d48987da044d09a485ba to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save KageDesu/c687dd264d00d48987da044d09a485ba to your computer and use it in GitHub Desktop.
Download ZIP
New Skills Panel (AABSZ)
Raw
aabsz_new_skill_panel_guide.md

New Skill Panel

⚠️ Information valid for version 0.11.3 and above

NewSkillPanelKB

The new Skill Panel is a redesigned interface for managing and viewing your character's skills. It offers improved usability (gamepad support) and a more intuitive and modern layout (NUI based) compared to the previous version.

Note: New skill panel automatically detects if gamepad is connected and enables gamepad controls.

NewSkillPanelGP

Plugin Parameters

skillPanelPP

Settings for the Skill Panel can be found in the plugin parameters, see "Skill Panel settings" group.

Common Settings

  • Skill Panel Configuration Menu Key - Key to open the Skill Panel binding skill menu in game.

  • Add Skill On Learning? - If enabled, newly learned skills will be automatically added to the skill panel if there is an empty slot available.

  • Add Item On Pick up? - If enabled, newly picked up items will be automatically added to the skill panel if there is an empty slot available. Only items with <ABS> notetag will be added.

  • Remove Zero Items? - If enabled, items with 0 quantity will be automatically removed from the skill panel.

  • Outline effect? - If enabled, an outline effect will be applied to skill and item icons in the skill panel. Disable this option to improve performance on lower-end devices.

  • Legacy Skill Panel - If enabled, the old skill panel will be used instead of the new one.

oldSkillPanel

Note: The old skill panel does not support gamepad controls and has a different layout. Maybe be deleted in future versions.

Note: Be sure to set Legacy Skill Panel to false to use the new skill panel.

legacyParameter

Action Slots

actionSlotsPP

Action Slots - Number of action slots to display in the skill panel. This determines how many skills or items can be assigned for quick access. Each slot have own position, visual settings, activation key and more. You can add as many slots as you want.

Action Slot Settings

Each action slot can be configured with the following parameters:

Unique Symbol (ID)

  • A unique identifier for the slot, used for binding skills and items to this specific slot. Used inside script calls to reference the slot.

Activation Key

  • The key combination to activate this action slot.
  • Supports keyboard, mouse, and gamepad inputs.
  • Structure: InputKey (contains keyboard, mouse, and gamepad button mappings).

Visual Settings

  • Appearance and display options for the action slot.
  • Structure: ActionSlotVisualSettings containing:
    • Visibility Switch - Game switch ID to control slot visibility (0 = always visible)
    • Opacity While Message - Slot opacity percentage when message window is shown (0-100)
    • Style - Visual style preset for the slot (default or custom). See Style Customization section for details.
    • Position X/Y - Screen coordinates for slot placement
    • Is Big Action Slot - Whether to display slot in enlarged size (used for more important skills/items, like primary and secondary attacks)

Is Editable?

  • Determines if the player can manually edit this slot by opening the skills or items selection menu.
  • If disabled, the slot can only be changed via script calls or auto-assignment.

Is Auto?

  • Enables automatic assignment of skills or items to this slot.
  • When enabled, newly learned skills or picked up items will be automatically placed in this slot if it's empty.

Filter

  • Restricts what can be auto-assigned to this slot (only works when "Is Auto?" is enabled).
  • Options: Any, Items, or Skills.

Specified Ids

  • Comma-separated list of specific skill or item IDs that can be assigned to this slot.
  • Only applies when "Is Auto?" is enabled.
  • Leave empty to allow all skills/items (based on filter).

Is Click Activation Allowed?

  • Determines if the player can activate this slot by clicking on it with mouse or touch input.

Is Only For Mobile Devices?

  • If enabled, this action slot will only be visible and usable on mobile devices with touchscreen.
  • Use this for creating mobile-specific control schemes.

Note: This option will not work in AABSZ 0.11.3 due to not implemented yet.

Assigning Skills to Action Slots

In-Game Instructions (for Player)

skillbindings

By Skill Panel Configuration Menu Key (set in plugin parameters), players can open the Skill Panel configuration menu to assign skills and items to action slots.

Player can click by RMB on an action slot to open the Skill Panel configuration menu as well.

Learnings

When a player learns a new skill, it will be automatically added to the first available empty action slot if the Add Skill On Learning? parameter is enabled.

classLearning

Extra Notetags

Actor's Notetags

defaultSecNote

You can set a default secondary skill (RMB or Q) for an actor using the following notetag in the actor's note box:

<defaultSecondarySkill:skillId>

Skills and Items Notetags

ssImgNote

You can set specific image for skill/item that will be displayed in the skill panel (instead of icon) using the following notetag in the skill's or item's note box:

ssImg:imageName

Note: ssImg stands for "skill slot image", must be inside <ABS> </ABS> tags.

Where imageName is the name of the image file located in the img/pictures/ folder.

Note: The old skill panel use images from img/Alpha folder, but new skill panel use images from img/pictures folder. You can change image folder in the default style NUI definition file if needed. See Style Customization section for details.

Script calls (managment via script)

You can assign skills or items to specific action slots via script calls. Use the following functions:

uAPI.setSkillToPanel(ID, SLOT_SYMBOL);

Where ID is the skill ID to assign, and SLOT_SYMBOL is the unique symbol of the action slot.

Example: uAPI.setSkillToPanel(10, '1'); will assign skill with ID 10 to action slot with symbol 1.

uAPI.setItemToPanel(ID, SLOT_SYMBOL);

Where ID is the item ID to assign, and SLOT_SYMBOL is the unique symbol of the action slot.

Note: For remove item/skill, use 0 instead ID Example: uAPI.setSkillToPanel(0, '5'); will remove skill from action slot with symbol 5.

Note:: For add item\skill to first available empty slot, use null instead SLOT_SYMBOL (or keep it empty) Example: uAPI.setItemToPanel(15); will assign item with ID 15 to first available empty action slot.

To get the skill or item ID currently assigned to a specific action slot, use the following functions:

uAPI.getSkillIdFromPanel(SLOT_SYMBOL);

Where SLOT_SYMBOL is the unique symbol of the action slot. This function returns the skill ID assigned to that slot, or 0 if no skill is assigned.

Style Customization

Each skill slot can use own layout style. By default all slots use default style preset (data\AABSZ\action_slots\default.json).

You can create custom styles by duplicating and editing the default style file or creating new style files.

To change the style of an action slot, modify the Style parameter in the action slot settings to the desired style preset name.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment