Inner Ability

Provides read access to the character's Inner Ability lines for the currently active preset, a manual circulate() re-roll, and the Auto Inner Ability engine that circulates until your goals are met.

#Line Object Structure

core.inner_ability.get_current() returns an array of line objects with the following properties:

The name is the ability's name only — it never carries the rolled value. The magnitude the game shows in the tooltip is resolved separately and is not exposed here.

#Inner Ability Grades

#Functions

#core.inner_ability.get_current() -> table

Returns an array of the active preset's Inner Ability lines (up to 3). Returns an empty table if unavailable.

local lines = core.inner_ability.get_current()
for _, line in ipairs(lines) do
    core.log(string.format("Slot %d (Grade %d): %s", line.pos, line.grade, line.name))
end

#core.inner_ability.get_active_preset() -> number

Returns the index of the currently active Inner Ability preset (0-based), or -1 if none. This is the preset get_current() reads and the default target of circulate().

#core.inner_ability.get_honor_exp() -> number

Returns the character's current Honor EXP — the currency spent circulating Inner Ability (capped at 9,999,999).

#core.inner_ability.circulate(preset_index?: number, lock_positions?: table) -> boolean

Re-rolls (circulates) the Inner Ability lines, spending Honor EXP. preset_index (0-based) defaults to the active preset. lock_positions is an optional array of slot numbers (1-3) to keep — the rest are re-rolled. Omit to re-roll all lines. Locking is only allowed once the preset is Unique grade or higher, and at least one slot must be left to re-roll.

-- Re-roll every line of the active preset
core.inner_ability.circulate()

-- Keep slot 1, re-roll the rest
core.inner_ability.circulate(core.inner_ability.get_active_preset(), { 1 })

#Auto Inner Ability

The functions above act once. Auto Inner Ability keeps circulating for you and stops on its own the moment the lines satisfy your goals, the Honor EXP floor is reached, or the circulate cap runs out. It is the same engine the web menu drives — right-click your character portrait on the Player screen and choose Auto Inner Ability — so a script and the menu can never disagree about a run.

#Goal Object Structure

Each entry of opts.goals describes one line you want. Every goal must be met by a different line, so two goals never both count the same lucky roll.

Prefer skill_ids: IDs are the same in every region, while names are localized, so an ID-based goal keeps working on a non-English client. Some abilities share a display name — "Increases Speed" is both 70000005 and 70000011 — so a goal that means "either" lists both.

#core.inner_ability.start(opts?: table) -> boolean, string?

Starts the Auto Inner Ability engine, returning false plus an error message if the options are invalid. Every option persists until changed, so omitting one keeps whatever the menu holds.

Every goal row is validated before it is stored. A row that names no ability at all (neither skill_ids nor a non-empty ability), or whose min_level / min_grade / skill_ids are the wrong type, is rejected with false and a message rather than being carried into the run.

core.inner_ability.start({
    min_grade = 3,                     -- every line Legendary
    goals = {
        -- Boss Monster Damage Increase, Legendary, level 20+
        { skill_ids = { 70000035 }, min_level = 20, min_grade = 3 },
    },
    min_honor = 50000,
    max_circulates = 100,
})

#core.inner_ability.stop() -> boolean

Stops a running Auto Inner Ability run. Safe to call when nothing is running.

#core.inner_ability.is_running() -> boolean

Returns whether an Auto Inner Ability run is currently active.

#core.inner_ability.get_status() -> table

Returns the live state of the run: running, state, preset, circulates_used, honor_spent, and a result table mirroring what the web menu shows.

result.status is one of circulating, rolling, done, no_honor, max_reached, preset_not_found, timeout or character_changed. honor is the character's Honor EXP balance at the time of the update. nextCost is the Honor EXP the run has reserved for its next circulate (see Circulate cost). startLines and currentLines are arrays of { pos, skillId, level, grade, name }, letting a script report what the run changed.

#Circulate cost

A circulate is priced by the preset's current rank and by how many lines are locked. Before each circulate the engine reserves the larger of this table's price for the current rank and lock count and the cost the previous circulate actually took, and refuses to spend when that would break min_honor. Taking the larger of the two matters: the table can be wrong about a given server, while an observed cost goes stale the moment the preset ranks up or a lock is added.

#Examples

#Print the active Inner Ability setup

local lines = core.inner_ability.get_current()
if #lines == 0 then
    core.log("No Inner Ability lines")
    return
end

for _, line in ipairs(lines) do
    core.log(string.format("[%d] %s (skill %d, grade %d)",
        line.pos, line.name, line.skill_id, line.grade))
end

#Circulate for a Legendary Boss Damage line, then report

core.inner_ability.start({
    min_grade = 3,
    goals = { { skill_ids = { 70000035 }, min_level = 30, min_grade = 3 } },
    max_circulates = 200,
})

function on_tick()
    if core.inner_ability.is_running() then return end

    -- Read the finished run's totals from `result` — the top-level counters
    -- are cleared as soon as the run ends.
    local result = core.inner_ability.get_status().result
    if result and result.status == "done" then
        core.log(string.format("Done in %d circulates (%d Honor EXP)",
            result.circulatesUsed, result.honorSpent))
    end
end

#Inner Ability Reference

Every ability a line can roll, from the client's own data (v270). Use these IDs in a goal's skill_ids.

Where two IDs share a name they are listed together — they are indistinguishable in-game, so a goal that wants that ability should list both.

The #placeholder in each effect is filled in by the game from the line's level; that per-level table is not readable from the client's data files, which is why it is shown raw.