💻Exports (Client)

名前表示関連

名前表示の切り替え

名前を表示する

local isVisible = exports['cats-advanced-name']:switchVisibleName(true)

名前を非表示にする

local isHidden = exports['cats-advanced-name']:switchVisibleName(false)

現在の状態を反転する（表示→非表示、または非表示→表示）

local isToggled = exports['cats-advanced-name']:switchVisibleName()

キャラクター名の変更

姓名を変更する

local success = exports['cats-advanced-name']:changeName('太郎', '山田')
if success then
    print('名前が変更されました')
end

名前ラベルの管理

ラベルを設定する（名前の上に表示される）

local success = exports['cats-advanced-name']:changeNameLabel('警察署長')

ラベルを削除する

exports['cats-advanced-name']:removeNameLabel()

現在の表示名取得

現在表示されている名前を取得する（ニックネームか本名）

local displayName = exports['cats-advanced-name']:getDisplayName()
print('現在の表示名: ' .. displayName)

ニックネーム管理

ニックネームの追加

新しいニックネームを追加

local success = exports['cats-advanced-name']:addNickname('ヤマさん')
if success then
    print('ニックネームが追加されました')
end

ニックネームの使用

保存済みのニックネームを使用

exports['cats-advanced-name']:useNickname('ヤマさん')

本名に戻す

ニックネームをやめて本名に戻す

exports['cats-advanced-name']:useCharacterName()

ニックネームリストの取得

保存済みのニックネーム一覧を取得

local nicknames = exports['cats-advanced-name']:getNicknames()
for i, nickname in ipairs(nicknames) do
    print(i .. ': ' .. nickname)
end

ニックネームの削除

特定のニックネームを削除

exports['cats-advanced-name']:deleteNickname('ヤマさん')

マーク関連

マークの切り替え

特定のマークを切り替える（有効→無効、または無効→有効）

local success = exports['cats-advanced-name']:toggleMark('police')
if success then
    print('警察マークが切り替えられました')
end

他のマーク例

exports['cats-advanced-name']:toggleMark('ems')      -- 救急マーク
exports['cats-advanced-name']:toggleMark('mechanic') -- 整備士マーク
exports['cats-advanced-name']:toggleMark('beginner') -- 初心者マーク

プレイヤーのマークリスト取得

自分のマークリストを取得

local myMarks = exports['cats-advanced-name']:getPlayerMarks()

特定プレイヤーのマークリストを取得（プレイヤーID指定）

local playerMarks = exports['cats-advanced-name']:getPlayerMarks(12)

マークの確認

for markId, isActive in pairs(myMarks) do
    if isActive then
        print('アクティブなマーク: ' .. markId)
    end
end

マークの状態確認

特定のマークがアクティブかどうか確認

local isPolice = exports['cats-advanced-name']:isMarkActive('police')
if isPolice then
    print('警察マークがアクティブです')
end

他のプレイヤーのマーク状態を確認

local hasEMS = exports['cats-advanced-name']:isMarkActive('ems', 12) -- プレイヤーID 12

マーク定義リストの取得

利用可能なすべてのマーク定義を取得

local markDefs = exports['cats-advanced-name']:getMarkDefinitions()
for i, def in ipairs(markDefs) do
    print(def.id .. ': ' .. def.label .. ' - ' .. def.emoji)
end

PVEモード関連

PVEモードの状態確認

現在のPVEモード状態を確認

local isPVE = exports['cats-advanced-name']:isPVEModeEnabled()
if isPVE then
    print('PVEモードが有効です')
else
    print('PVEモードは無効です')
end

PVEモードの切り替え

PVEモードを有効にする

exports['cats-advanced-name']:togglePVEMode(true)

PVEモードを無効にする

exports['cats-advanced-name']:togglePVEMode(false)

Last updated 1 month ago