papermario/tools/disasm_script.py
HailSanta ce4ab34def
battle/actor flags and more (#1119)
* battle documentation

* mostly startup stuff

* battle file names

* minor reorg

* actor rendering

* few extras

* file renames and camera unks

* py fix

* fio cleanup

* sounds progress

---------

Co-authored-by: HailSanta <Hail2Santa@gmail.com>
2023-10-14 15:43:12 -04:00

1312 lines
48 KiB
Python
Executable File

#!/usr/bin/env python3
import sym_info
from pathlib import Path
_script_lib = None
def script_lib(offset=0):
global _script_lib
if not _script_lib:
_script_lib = {}
from os import path
import re
# star rod database
"""
LIB_LINE_RE = re.compile(r"\s+:\s+")
NAME_RE = re.compile(r"({[^}]*})?\s*([a-zA-Z0-9_]+)")
for filename in Path(path.dirname(__file__), "star-rod", "database").rglob("*.lib"):
with open(filename, "r") as file:
for line in file.readlines():
parts = LIB_LINE_RE.split(line)
if len(parts) >= 3:
try:
kind = parts[0]
vaddr = int(parts[1].split(", ")[0], 16)
if name := NAME_RE.match(parts[2]):
name = name.group(2)
_script_lib[vaddr] = name
except:
pass
"""
repo_root = Path(__file__).resolve().parent.parent
symbols = Path(repo_root / "ver" / "current" / "symbol_addrs.txt")
with open(symbols, "r") as file:
for line in file.readlines():
s = [s.strip() for s in line.split("=", 1)]
name = s[0]
vaddr = int(s[1].split(";")[0].split(" ")[0], 16)
raddr = "0xFFFFFFFF"
if "rom:" in line:
raddr = line.split("rom:", 1)[1]
if " " in raddr:
raddr = raddr.split(" ", 1)[0]
raddr = raddr.strip()
if vaddr not in _script_lib:
_script_lib[vaddr] = []
_script_lib[vaddr].append([int(raddr, 16), name])
"""
# Sort the symbols for each vram address by the difference
# between their rom address and the offset passed in.
# If offset - rom address goes below 0, it's part of the
# previous file, so treat it as min priority, same as a default.
# After sorting, the first rom address and name should be the best candidate.
for k in _script_lib.keys():
for i,entry in enumerate(_script_lib[k]):
diff = offset - entry[0]
entry[0] = 0xFFFFFFFF if diff < 0 else diff
_script_lib[k][i][0] = entry[0]
_script_lib[k] = sorted(_script_lib[k], key=lambda x: x[0])
"""
return _script_lib
def extend_symbol_map(a, b):
for k in b:
if k not in a:
a[k] = b[k]
else:
a[k] += b[k]
return a
def round_fixed(f: float) -> float:
g = f * 100.0
whole = round(g)
if abs(g - whole) <= 100.0 / 1024.0:
f = whole / 100.0
return f
def find_symbol_in_overlay(symbol_map, overlay_rom_addr, symbol_ram_addr):
if not symbol_ram_addr in symbol_map:
return None
lowest_delta = None
lowest_symbol_name = None
for rom_addr, symbol_name in symbol_map[symbol_ram_addr]:
delta = rom_addr - overlay_rom_addr
if delta >= 0 and (lowest_delta is None or delta <= lowest_delta):
lowest_delta = delta
lowest_symbol_name = symbol_name
if lowest_symbol_name:
return lowest_symbol_name
return symbol_map[symbol_ram_addr][0][1]
def browse_header(valid_enums, enums):
# enums
for i, line in enumerate(enums):
if (line.startswith("enum ")) or (line.startswith("typedef enum ")):
enum_name = line.split("enum ", 1)[1].split(" {", 1)[0]
if enum_name in valid_enums:
CONSTANTS[enum_name] = {}
last_num = -1
i += 1
while "}" not in enums[i]:
if not enums[i]:
i += 1
continue
if "//" in enums[i]:
name = enums[i].split("//", 1)[0].strip()
else:
name = enums[i].strip()
val = last_num + 1
if "=" in name:
name, val = name.split(" = ")
val = int(val[:-1], 0)
if val > 0x80000000:
val -= 0x100000000
else:
name = name[:-1]
name = name.strip()
# print("\"" + name + "\"", "===", val)
CONSTANTS[enum_name][val] = name.strip()
i += 1
last_num = val
return
# Grab CONSTANTS from the include/ folder to save manual work
CONSTANTS = {}
SWITCH_TYPES = []
LOCAL_WORDS = [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
SAVE_VARS = set()
def get_constants():
global CONSTANTS
global VALID_SAVE_VARS
valid_enums = {
"StoryProgress",
"ItemIDs",
"PlayerAnims",
"ActorType",
"ActorIDs",
"Events",
"SoundIDs",
"SongIDs",
"Locations",
"AmbientSounds",
"NpcIDs",
"Emotes",
"NpcFlags",
"Statuses",
"Elements",
"DamageTypes",
"ElementImmunityFlags",
"HitResults",
"ActorFlags",
"ActorPartFlags",
"ActorEventFlags",
"ElementFlags",
"EncounterTriggers",
"Abilities",
"EasingType",
"DecorationIDs",
"HitResults",
"Phases",
"ItemSpawnModes",
"ActionStates",
"Triggers",
"Buttons",
"ActionCommand",
"MoveIDs",
"BattleStatusFlags1",
"BattleStatusFlags2",
"BtlCameraPreset",
"EffectID",
"StatusFlags",
}
for enum in valid_enums:
CONSTANTS[enum] = {}
CONSTANTS["NPC_SPRITE"] = {}
CONSTANTS["MAP_NPCS"] = {}
[SAVE_VARS.add(x) for x in ["GB_WorldLocation", "GB_StoryProgress"]]
include_path = Path(Path(__file__).resolve().parent.parent / "include")
enums = Path(include_path / "enums.h").read_text().splitlines()
browse_header(valid_enums, enums)
enums = Path(include_path / "effects.h").read_text().splitlines()
browse_header(valid_enums, enums)
include_path = Path(Path(__file__).resolve().parent.parent / "src" / "battle")
enums = Path(include_path / "battle.h").read_text().splitlines()
browse_header(valid_enums, enums)
"""
# defines
for line in enums:
this_enum = ""
for enum in valid_defines:
if f"#define {enum}_" in line:
this_enum = enum
break;
if this_enum:
name = line.split(" ",2)[1]
id_ = line.split("0x", 1)[1]
if " " in id_:
id_ = id_.split(" ",1)[0]
CONSTANTS[this_enum][int(id_, 16)] = name
"""
# exit()
# sprites
sprite_path = Path(
Path(__file__).resolve().parent.parent / "ver" / "current" / "build" / "include" / "sprite" / "npc"
)
for file in sprite_path.iterdir():
fd = file.read_text()
for line in fd.splitlines():
if "#define NPC_ANIM_" not in line:
continue
header_file_name = file.parts[-1]
name = line.split(" ", 2)[1]
value = int(line.split("0x", 1)[1], base=16)
CONSTANTS["NPC_SPRITE"][value] = name
CONSTANTS["NPC_SPRITE"][str(value) + ".h"] = header_file_name
return
def make_anim_macro(self, sprite, palette, anim):
if sprite == 0xFF and palette == 0xFF and anim == 0xFF:
return "-1"
value = (sprite << 16) | (palette << 8) | anim
if value in CONSTANTS["NPC_SPRITE"]:
self.INCLUDES_NEEDED["sprites"].add(CONSTANTS["NPC_SPRITE"][str(value) + ".h"])
return CONSTANTS["NPC_SPRITE"][value]
else:
return f"0x{sprite:02X}{palette:02X}{anim:02X}"
def remove_evt_ptr(s):
if s.startswith("EVT_PTR("):
return s[8:-1]
else:
return s
def make_flags(argNum, flags, new_args):
enabled = []
for x in range(32):
flag = argNum & (1 << x)
if flag:
if flag in CONSTANTS[flags]:
enabled.append(CONSTANTS[flags][flag])
else:
enabled.append(f"0x{flag:08X}")
if not enabled:
enabled.append(f"0")
new_args.append(" | ".join(enabled))
def fix_args(self, func, args, info):
global CONSTANTS
new_args = []
args = args.split(", ")
for i, arg in enumerate(args):
if (remove_evt_ptr(arg).startswith("D_B")) or (i == 0 and func == "MakeEntity" and arg.startswith("D_")):
if func == "MakeEntity":
arg = "MAKE_ENTITY_END"
else:
arg = "0x" + remove_evt_ptr(arg)[2:]
if "0x" in arg and int(remove_evt_ptr(arg), 16) >= 0xF0000000:
arg = f"{int(remove_evt_ptr(arg), 16) - 0x100000000}"
if i in info or (i + 1 == len(args) and -1 in info):
if arg.startswith("LW"):
argNum = trim_lw(arg)
LOCAL_WORDS[int(argNum)] = info[i]
new_args.append(f"{arg}")
# print(LOCAL_WORDS)
continue
if i + 1 == len(args) and -1 in info:
i = -1
if "_" in arg:
new_args.append(f"{arg}")
continue
try:
argNum = int(arg, 0)
except ValueError:
new_args.append(f"{arg}")
continue
if info[i] == "Bool":
new_args.append(f"{'TRUE' if argNum == True else 'FALSE'}")
elif info[i] == "Hex" and argNum > 0:
new_args.append(f"0x{argNum:08X}")
elif info[i] == "CustomAnim":
if argNum != -1:
try:
value = argNum & 0x00FFFFFF
if func == "SetAnimation" and int(new_args[1], 10) == 0:
call = f"{CONSTANTS['PlayerAnims'][argNum]}"
elif value in CONSTANTS["NPC_SPRITE"]:
self.INCLUDES_NEEDED["sprites"].add(CONSTANTS["NPC_SPRITE"][str(value) + ".h"])
call = CONSTANTS["NPC_SPRITE"][value]
else:
call = f"{argNum:06X}"
except ValueError:
call = f"0x{argNum:06X}"
except KeyError:
call = f"0x{argNum:06X}"
else:
call = "-1"
new_args.append(call)
elif info[i] == "CustomMsg":
type_ = (argNum & 0xFF0000) >> 16
num_ = (argNum & 0xFFFF) >> 0
new_args.append(f"MESSAGE_ID(0x{type_:02X}, 0x{num_:04X})")
elif info[i] == "NpcFlags":
make_flags(argNum, "NpcFlags", new_args)
elif info[i] == "DamageTypes":
make_flags(argNum, "DamageTypes", new_args)
elif info[i] == "ActorPartFlags":
make_flags(argNum, "ActorPartFlags", new_args)
elif info[i] == "ActorFlags":
make_flags(argNum, "ActorFlags", new_args)
elif info[i] == "BattleStatusFlags1":
make_flags(argNum, "BattleStatusFlags1", new_args)
elif info[i] == "BattleStatusFlags2":
make_flags(argNum, "BattleStatusFlags2", new_args)
elif info[i] == "StatusFlags":
make_flags(argNum, "StatusFlags", new_args)
elif info[i] == "NpcIDs":
if argNum >= 0:
if argNum in CONSTANTS["MAP_NPCS"]:
new_args.append(CONSTANTS["MAP_NPCS"][argNum])
else:
new_args.append(str(argNum))
else:
new_args.append(CONSTANTS["NpcIDs"][argNum])
elif info[i] == "SoundIDs":
if argNum in CONSTANTS["SoundIDs"]:
new_args.append(CONSTANTS["SoundIDs"][argNum])
else:
new_args.append("0x%X" % argNum)
elif info[i] == "StoryProgress":
print(info[i])
if argNum in CONSTANTS["StoryProgress"]:
new_args.append(CONSTANTS["StoryProgress"][argNum])
else:
new_args.append(str(argNum))
else:
try:
new_args.append(f"{CONSTANTS[info[i]][argNum]}")
except KeyError:
if not (info[i] == "NpcIDs" and argNum > 0):
print(
f"0x{argNum:X} was not found within {info[i]} constants for function {func} arg {i}, add it."
)
if info[i] == "ItemIDs" and argNum < 0:
new_args.append(f"{int(argNum)}")
else:
# Print the unknowns in hex
new_args.append(self.var(argNum))
else:
new_args.append(f"{arg}")
return ", ".join(new_args)
replace_funcs = {
"ActorExists": {0: "ActorIDs", 1: "Bool"},
"ActorSpeak": {0: "CustomMsg", 1: "ActorIDs", 3: "CustomAnim", 4: "CustomAnim"},
"AddActorDecoration": {0: "ActorIDs"},
"AddActorVar": {0: "ActorIDs"},
"AddKeyItem": {0: "ItemIDs"},
"AddGoalPos": {0: "ActorIDs"},
"BattleCamTargetActor": {0: "ActorIDs"},
"BindHandleEvent": {0: "ActorIDs"},
"BindIdle": {0: "ActorIDs"},
"BindHandlePhase": {0: "ActorIDs"},
"BindNpcAI": {0: "NpcIDs"},
"BindNpcDefeat": {0: "NpcIDs"},
"BindNpcIdle": {0: "NpcIDs"},
"BindNpcInteract": {0: "NpcIDs"},
"BindTakeTurn": {0: "ActorIDs"},
"CheckButtonDown": {0: "Hex", 1: "Bool"},
"ContinueSpeech": {1: "CustomAnim", 2: "CustomAnim", 4: "CustomMsg"},
"CopyBuffs": {0: "ActorIDs", 1: "ActorIDs"},
"CopyStatusEffects": {0: "ActorIDs", 1: "ActorIDs"},
"CountTargets": {0: "ActorIDs"},
"DisablePlayerInput": {0: "Bool"},
"DisablePlayerPhysics": {0: "Bool"},
"DispatchDamagePlayerEvent": {1: "Events"},
"DispatchEvent": {0: "ActorIDs", 1: "Events"},
"EnableActorBlur": {0: "ActorIDs"},
"EnableActorGlow": {0: "ActorIDs", 1: "Bool"},
"EnableIdleScript": {0: "ActorIDs"},
"EnableNpcShadow": {0: "NpcIDs", 1: "Bool"},
"EndActorSpeech": {0: "ActorIDs", 2: "CustomAnim", 3: "CustomAnim"},
"EndSpeech": {1: "CustomAnim", 2: "CustomAnim"},
"EnemyDamageTarget": {
0: "ActorIDs",
1: "HitResults",
2: "DamageTypes",
4: "StatusFlags",
6: "BattleStatusFlags1",
},
"EnemyTestTarget": {
0: "ActorIDs",
1: "HitResults",
2: "DamageTypes",
3: "StatusFlags",
5: "BattleStatusFlags1",
},
"FallToGoal": {0: "ActorIDs"},
"FindKeyItem": {0: "ItemIDs"},
"FlyPartTo": {0: "ActorIDs"},
"FlyToGoal": {0: "ActorIDs"},
"ForceHomePos": {0: "ActorIDs"},
"GetPartAnimNotify": {0: "ActorIDs"},
"SetActorPaletteEffect": {0: "ActorIDs"},
"SetActorPaletteSwapParams": {0: "ActorIDs"},
"EnableActorPaletteEffects": {0: "ActorIDs"},
"HideHealthBar": {0: "ActorIDs"},
"func_8027D434": {0: "ActorIDs"},
"SetProjectileTargetOffset": {0: "ActorIDs"},
"GetInstigatorValue": {0: "ActorIDs"},
"SetNpcFoldParams": {0: "NpcIDs"},
"SetNpcFoldFlags": {0: "NpcIDs"},
"UpdatePlayerFold": {0: "PlayerAnims"},
"GetAnimation": {0: "ActorIDs", 2: "CustomAnim"},
"GetActorFlags": {0: "ActorIDs", 1: "ActorFlags"},
"GetActorHP": {0: "ActorIDs"},
"GetActorPos": {0: "ActorIDs"},
"GetActorSize": {0: "ActorIDs"},
"GetActorVar": {0: "ActorIDs"},
"GetBattleFlags": {0: "BattleStatusFlags1"},
"GetBattlePhase": {0: "Phases"},
"GetDistanceToGoal": {0: "ActorIDs"},
"GetEnemyMaxHP": {0: "ActorIDs"},
"GetGoalPos": {0: "ActorIDs"},
"GetHomePos": {0: "ActorIDs"},
"GetIdleGoal": {0: "ActorIDs"},
"GetIndexFromHome": {0: "ActorIDs"},
"GetIndexFromPos": {0: "ActorIDs"},
"GetItemPower": {0: "ItemIDs"},
"GetLastDamage": {0: "ActorIDs"},
"GetLastElement": {0: "DamageTypes"},
"GetLastEvent": {0: "ActorIDs", 1: "Events"},
"GetPartOffset": {0: "ActorIDs"},
"GetPartPos": {0: "ActorIDs"},
"GetPartRotation": {0: "ActorIDs"},
"GetNpcPos": {0: "NpcIDs"},
"GetOriginalActorType": {0: "ActorIDs", 1: "ActorType"},
"GetStatusFlags": {0: "ActorIDs", 1: "StatusFlags"},
"HidePlayerShadow": {0: "Bool"},
"HPBarToCurrent": {0: "ActorIDs"},
"HPBarToHome": {0: "ActorIDs"},
"IdleFlyToGoal": {0: "ActorIDs"},
"IdleJumpToGoal": {0: "ActorIDs"},
"IdleRunToGoal": {0: "ActorIDs"},
"InterpNpcYaw": {0: "NpcIDs"},
"JumpPartTo": {0: "ActorIDs"},
"JumpToGoal": {0: "ActorIDs", 2: "Bool", 3: "Bool", 4: "Bool"},
"JumpWithBounce": {0: "ActorIDs"},
"LandJump": {0: "ActorIDs"},
"LoadActionCommand": {0: "ActionCommand"},
"MakeEntity": {0: "Hex"},
"MakeItemEntity": {0: "ItemIDs"},
"ModifyColliderFlags": {2: "Hex"},
"NpcFaceNpc": {0: "NpcIDs", 1: "NpcIDs"},
"NpcFacePlayer": {0: "NpcIDs"},
"NpcJump0": {0: "NpcIDs"},
"NpcJump1": {0: "NpcIDs"},
"NpcMoveTo": {0: "NpcIDs"},
"PlayAmbientSounds": {0: "AmbientSounds"},
"PlayEffect": {0: "EffectID"},
"PlayLoopingSoundAtActor": {0: "ActorIDs", 2: "SoundIDs"},
"PlaySound": {0: "SoundIDs"},
"PlaySoundAt": {0: "SoundIDs"},
"PlaySoundAtActor": {0: "ActorIDs", 1: "SoundIDs"},
"PlaySoundAtModel": {1: "SoundIDs"},
"PlaySoundAtNpc": {0: "NpcIDs", 1: "SoundIDs"},
"PlaySoundAtPart": {0: "ActorIDs", 2: "SoundIDs"},
"RemoveActor": {0: "ActorIDs"},
"RemoveActorDecoration": {0: "ActorIDs"},
"RemoveNpc": {0: "NpcIDs"},
"ResetActorSounds": {0: "ActorIDs"},
"ResetAllActorSounds": {0: "ActorIDs"},
"RunToGoal": {0: "ActorIDs", 2: "Bool"},
"SetActorDispOffset": {0: "ActorIDs"},
"SetActorFlagBits": {0: "ActorIDs", 1: "ActorFlags"},
"SetActorIdleSpeed": {0: "ActorIDs"},
"SetActorIdleJumpGravity": {0: "ActorIDs"},
"SetActorJumpGravity": {0: "ActorIDs"},
"SetActorPos": {0: "ActorIDs"},
"SetActorRotation": {0: "ActorIDs"},
"SetActorRotationOffset": {0: "ActorIDs"},
"SetActorScale": {0: "ActorIDs"},
"SetActorSize": {0: "ActorIDs"},
"SetActorSounds": {0: "ActorIDs"},
"SetActorSpeed": {0: "ActorIDs"},
"SetActorType": {0: "ActorIDs", 1: "ActorType"},
"SetActorVar": {0: "ActorIDs"},
"SetActorYaw": {0: "ActorIDs"},
"SetAnimation": {0: "ActorIDs", 2: "CustomAnim"},
"SetAnimationRate": {0: "ActorIDs"},
"SetBattleFlagBits": {0: "BattleStatusFlags1"},
"SetBattleFlagBits2": {0: "BattleStatusFlags2"},
"SetDefenseTable": {0: "ActorIDs"},
"SetEnemyHP": {0: "ActorIDs"},
"SetEnemyTargetOffset": {0: "ActorIDs"},
"SetGoalPos": {0: "ActorIDs"},
"SetGoalToFirstTarget": {0: "ActorIDs"},
"SetGoalToHome": {0: "ActorIDs"},
"SetGoalToIndex": {0: "ActorIDs"},
"SetGoalToTarget": {0: "ActorIDs"},
"SetHomePos": {0: "ActorIDs"},
"SetIdleAnimations": {0: "ActorIDs"},
"SetIdleGoal": {0: "ActorIDs"},
"SetIdleGoalToHome": {0: "ActorIDs"},
"SetJumpAnimations": {
0: "ActorIDs",
2: "PlayerAnims",
3: "PlayerAnims",
4: "PlayerAnims",
},
"SetMusicTrack": {1: "SongIDs"},
"SetNpcAnimation": {0: "NpcIDs", 1: "CustomAnim"},
"SetNpcAux": {0: "NpcIDs"},
"SetNpcFlagBits": {0: "NpcIDs", 1: "NpcFlags", 2: "Bool"},
"SetNpcJumpscale": {0: "NpcIDs"},
"SetNpcPos": {0: "NpcIDs"},
"SetNpcRotation": {0: "NpcIDs"},
"SetNpcScale": {0: "NpcIDs"},
"SetNpcSpeed": {0: "NpcIDs"},
"SetNpcSprite": {1: "Hex"},
"SetNpcYaw": {0: "NpcIDs"},
"SetOwnerID": {0: "ActorIDs"},
"SetPartAlpha": {0: "ActorIDs"},
"SetPartDispOffset": {0: "ActorIDs"},
"SetPartEventBits": {0: "ActorIDs", 2: "ActorEventFlags"},
"SetPartFlags": {0: "ActorIDs", 2: "ActorPartFlags"},
"SetPartFlagBits": {0: "ActorIDs", 2: "ActorPartFlags"},
"SetPartJumpGravity": {0: "ActorIDs"},
"SetPartMoveSpeed": {0: "ActorIDs"},
"SetPartPos": {0: "ActorIDs"},
"SetPartRotation": {0: "ActorIDs"},
"SetPartRotationOffset": {0: "ActorIDs"},
"SetPartScale": {0: "ActorIDs"},
"SetPartSize": {0: "ActorIDs"},
"SetPartSounds": {0: "ActorIDs"},
"SetPartTargetFlagBits": {0: "ActorIDs"},
"SetPartYaw": {0: "ActorIDs"},
"SetPlayerAnimation": {0: "PlayerAnims"},
"SetSelfEnemyFlagBits": {0: "NpcFlags", 1: "Bool"},
# "SetSelfVar" :{1:"Bool"}, # apparently this was a bool in some scripts but it passes non-0/1 values, including negatives
"SetSpriteShading": {0: "CustomAnim"},
"SetStatusTable": {0: "ActorIDs"},
"SetTargetActor": {0: "ActorIDs", 1: "ActorIDs"},
"SetTargetOffset": {0: "ActorIDs"},
"ShowChoice": {0: "CustomMsg"},
"ShowEmote": {1: "Emotes"},
"ShowMessageAtScreenPos": {0: "CustomMsg"},
"ShowMessageAtWorldPos": {0: "CustomMsg"},
"SpeakToPlayer": {0: "NpcIDs", 1: "CustomAnim", 2: "CustomAnim", -1: "CustomMsg"},
"StopLoopingSoundAtActor": {0: "ActorIDs"},
"SwitchMessage": {0: "CustomMsg"},
"UseBattleCamPreset": {0: "BtlCameraPreset"},
"UseIdleAnimation": {0: "ActorIDs", 1: "Bool"},
"WasStatusInflicted": {0: "ActorIDs", 1: "Bool"},
}
def trim_lw(arg):
return arg[arg.find("(") + 1 : arg.find(")")]
def replace_constants(self, func, args):
global replace_funcs
global LOCAL_WORDS
new_args = []
new_args = args.split(", ")
for i, new_arg in enumerate(new_args):
if new_arg.startswith("LW"):
new_arg = trim_lw(new_arg)
LOCAL_WORDS[int(new_arg)] = 0
if func in replace_funcs:
return fix_args(self, func, args, replace_funcs[func])
return args
def fix_1_arg(self, lw, arg, format):
if lw:
lw = int(trim_lw(lw))
if LOCAL_WORDS[lw]:
info = {0: LOCAL_WORDS[lw]}
args = f"{arg}"
return fix_args(self, 0, args, info)
if format:
info = {0: format}
args = f"{arg}"
return fix_args(self, 0, args, info)
return arg
class ScriptDisassembler:
def __init__(
self,
bytes,
script_name="script",
symbol_map={},
romstart=0,
INCLUDES_NEEDED={"forward": [], "sprites": set(), "npcs": []},
INCLUDED={"functions": set(), "includes": set()},
prelude=True,
transform_symbol_name=None,
use_script_lib=True,
):
self.bytes = bytes
self.script_name = script_name
self.prelude = prelude
if use_script_lib:
self.symbol_map = extend_symbol_map(symbol_map, script_lib(self.bytes.tell()))
else:
self.symbol_map = symbol_map
self.romstart = romstart
self.transform_symbol_name = transform_symbol_name
self.INCLUDES_NEEDED = INCLUDES_NEEDED
self.INCLUDED = INCLUDED
self.out = ""
self.prefix = ""
self.indent = 1
self.indent_used = False
self.done = False
self.start_pos = self.bytes.tell()
self.end_pos = 0
self.instructions = 0
def disassemble(self):
while True:
opcode = self.read_word()
argc = self.read_word()
# print(f"Op {opcode:X}, argc {argc}")
if opcode > 0xFF or argc > 0xFF:
raise Exception(f"script '{self.script_name}' is malformed (opcode {opcode:X}, argc {argc:X})")
argv = []
for i in range(0, argc):
argv.append(self.read_word())
# print(argv)
self.disassemble_command(opcode, argc, argv)
self.instructions += 1
if self.done:
self.end_pos = self.bytes.tell()
return self.prefix + self.out
def write(self, line):
if self.indent < 0:
self.indent = 0
if self.indent > 1:
self.indent_used = True
self.out += " " * self.indent
self.out += line
def write_line(self, line):
self.write(line)
self.out += "\n"
def prefix_line(self, line):
self.prefix += line
self.prefix += "\n"
def var(self, arg, prefer_hex=False, use_evt_ptr=True):
if arg in self.symbol_map:
s = self.symbol_map[arg][0][1]
return f"EVT_PTR({s})" if use_evt_ptr else s
v = arg - 2**32 # convert to s32
if v > -250000000:
if v <= -220000000:
return f"EVT_FLOAT({round_fixed((v + 230000000) / 1024)})"
elif v <= -200000000:
return f"ArrayFlag({v + 210000000})"
elif v <= -180000000:
return f"ArrayVar({v + 190000000})"
elif v <= -160000000:
return f"GameByte({v + 170000000})"
elif v <= -140000000:
return f"AreaByte({v + 150000000})"
elif v <= -120000000:
return f"GameFlag({v + 130000000})"
elif v <= -100000000:
return f"AreaFlag({v + 110000000})"
elif v <= -80000000:
return f"MapFlag({v + 90000000})"
elif v <= -60000000:
return f"LocalFlag({v + 70000000})"
elif v <= -40000000:
return f"MapVar({v + 50000000})"
elif v <= -20000000:
return f"LocalVar({v + 30000000})"
if arg == 0xFFFFFFFF:
return "-1"
elif (arg & 0xFF000000) == 0x80000000:
return f"0x{arg:X}"
elif arg >= 0x80000000:
return f"{arg - 0x100000000}"
elif prefer_hex and arg > 0:
return f"0x{arg:X}"
else:
return f"{arg}"
def replace_star_rod_function_name(self, name):
vram = int(name.split("_", 1)[1], 16)
name = "N(" + name.replace("function", "func") + f"_{(vram - 0x80240000)+self.romstart:X}" + ")"
return name
def replace_star_rod_prefix(self, addr, isArg=False):
if type(addr) is str:
return addr
if addr > 0x80000000 and addr in self.symbol_map:
name = find_symbol_in_overlay(self.symbol_map, self.romstart, addr)
if self.transform_symbol_name:
name = self.transform_symbol_name(name)
toReplace = True
suffix = ""
if False and name.startswith("N(func_"):
prefix = "ApiStatus "
name = self.replace_star_rod_function_name(name[2:-1])
suffix = "(Evt* script, s32 isInitialCall)"
elif name[2:-1] in self.INCLUDED["includes"]:
prefix = "ApiStatus "
suffix = "(Evt* script, s32 isInitialCall)"
elif name.startswith("N(npcAISettings_"):
prefix = "MobileAISettings "
elif name.startswith("N(npcSettings_"):
prefix = "NpcSettings "
elif name.startswith("N(npcGroup_"):
prefix = "NpcData "
elif name.startswith("N(entryList_"):
prefix = "EntryList "
elif name.startswith("N(npcGroupList_"):
prefix = "NpcGroupList "
elif name.startswith("N("):
prefix = "EvtScript "
else:
toReplace = False
if toReplace:
if name not in self.INCLUDED["functions"]:
self.INCLUDES_NEEDED["forward"].append(prefix + name + suffix + ";")
self.INCLUDED["functions"].add(name)
return name
elif not isArg or name.startswith('"'):
return name
else:
return str(addr)
return addr
def addr_ref(self, addr, isArg=False):
if addr in self.symbol_map:
return self.replace_star_rod_prefix(addr, isArg)
return self.var(addr) # f"0x{addr:08X}"
def trigger(self, trigger):
if trigger == 0x00000040:
trigger = "TRIGGER_WALL_PUSH"
if trigger == 0x00000080:
trigger = "TRIGGER_FLOOR_TOUCH"
if trigger == 0x00000100:
trigger = "TRIGGER_WALL_PRESS_A"
if trigger == 0x00000200:
trigger = "TRIGGER_FLOOR_JUMP"
if trigger == 0x00000400:
trigger = "TRIGGER_WALL_TOUCH"
if trigger == 0x00000800:
trigger = "TRIGGER_FLOOR_PRESS_A"
if trigger == 0x00001000:
trigger = "TRIGGER_WALL_HAMMER"
if trigger == 0x00010000:
trigger = "TRIGGER_GAME_FLAG_SET"
if trigger == 0x00020000:
trigger = "TRIGGER_AREA_FLAG_SET"
if trigger == 0x00040000:
trigger = "TRIGGER_CEILING_TOUCH"
if trigger == 0x00080000:
trigger = "TRIGGER_FLOOR_ABOVE"
if trigger == 0x00100000:
trigger = "TRIGGER_POINT_BOMB"
return f"0x{trigger:X}" if type(trigger) is int else trigger
def read_word(self):
return int.from_bytes(self.bytes.read(4), byteorder="big")
def disassemble_command(self, opcode, argc, argv):
if opcode == 0x01:
self.write_line("EVT_END")
self.indent -= 1
if self.prelude:
try:
self.prefix_line(
f"EvtScript D_{self.script_name - info[0] + info[2]:08X}_{self.script_name:06X} = {{"
)
self.write_line("};")
except:
self.prefix_line(f"EvtScript {self.script_name} = {{")
self.write_line("};")
self.done = True
elif opcode == 0x02:
self.write_line(f"EVT_RETURN")
elif opcode == 0x03:
self.write_line(f"EVT_LABEL({self.var(argv[0])})")
elif opcode == 0x04:
self.write_line(f"EVT_GOTO({self.var(argv[0])})")
elif opcode == 0x05:
self.write_line(f"EVT_LOOP({self.var(argv[0])})")
self.indent += 1
elif opcode == 0x06:
self.indent -= 1
self.write_line("EVT_END_LOOP")
elif opcode == 0x07:
self.write_line(f"EVT_BREAK_LOOP")
elif opcode == 0x08:
self.write_line(f"EVT_WAIT({self.var(argv[0])})")
elif opcode == 0x09:
self.write_line(f"EVT_WAIT_SECS({self.var(argv[0])})")
elif opcode == 0x0A:
if self.var(argv[0]).startswith("LW"):
args_str = fix_1_arg(self, self.var(argv[0]), self.var(argv[1]), 0)
else:
args_str = self.var(argv[1])
self.write_line(f"EVT_IF_EQ({self.var(argv[0])}, {args_str})")
self.indent += 1
elif opcode == 0x0B:
if self.var(argv[0]).startswith("LW"):
args_str = fix_1_arg(self, self.var(argv[0]), self.var(argv[1]), 0)
else:
args_str = self.var(argv[1])
self.write_line(f"EVT_IF_NE({self.var(argv[0])}, {args_str})")
self.indent += 1
elif opcode == 0x0C:
self.write_line(f"EVT_IF_LT({self.var(argv[0])}, {self.var(argv[1])})")
self.indent += 1
elif opcode == 0x0D:
self.write_line(f"EVT_IF_GT({self.var(argv[0])}, {self.var(argv[1])})")
self.indent += 1
elif opcode == 0x0E:
self.write_line(f"EVT_IF_LE({self.var(argv[0])}, {self.var(argv[1])})")
self.indent += 1
elif opcode == 0x0F:
self.write_line(f"EVT_IF_GE({self.var(argv[0])}, {self.var(argv[1])})")
self.indent += 1
elif opcode == 0x10:
args_str = fix_1_arg(self, self.var(argv[0]), self.var(argv[1]), "Hex")
self.write_line(f"EVT_IF_FLAG({self.var(argv[0])}, {args_str})")
self.indent += 1
elif opcode == 0x11:
args_str = fix_1_arg(self, self.var(argv[0]), self.var(argv[1]), "Hex")
self.write_line(f"EVT_IF_NOT_FLAG({self.var(argv[0])}, {args_str})")
self.indent += 1
elif opcode == 0x12:
self.indent -= 1
self.write_line(f"EVT_ELSE")
self.indent += 1
elif opcode == 0x13:
self.indent -= 1
self.write_line(f"EVT_END_IF")
elif opcode == 0x14:
new_arg = trim_lw(self.var(argv[0]))
SWITCH_TYPES.append(LOCAL_WORDS[int(new_arg)])
self.write_line(f"EVT_SWITCH({self.var(argv[0])})")
self.indent += 2
elif opcode == 0x15:
self.write_line(f"EVT_SWITCH_CONST(0x{argv[0]:X})")
self.indent += 2
elif opcode == 0x16:
self.indent -= 1
args_str = fix_1_arg(self, 0, self.var(argv[0]), SWITCH_TYPES[-1])
self.write_line(f"EVT_CASE_EQ({args_str})")
self.indent += 1
elif opcode == 0x17:
self.indent -= 1
args_str = fix_1_arg(self, 0, self.var(argv[0]), SWITCH_TYPES[-1])
self.write_line(f"EVT_CASE_NE({args_str})")
self.indent += 1
elif opcode == 0x18:
self.indent -= 1
self.write_line(f"EVT_CASE_LT({self.var(argv[0])})")
self.indent += 1
elif opcode == 0x19:
self.indent -= 1
self.write_line(f"EVT_CASE_GT({self.var(argv[0])})")
self.indent += 1
elif opcode == 0x1A:
self.indent -= 1
self.write_line(f"EVT_CASE_LE({self.var(argv[0])})")
self.indent += 1
elif opcode == 0x1B:
self.indent -= 1
self.write_line(f"EVT_CASE_GE({self.var(argv[0])})")
self.indent += 1
elif opcode == 0x1C:
self.indent -= 1
self.write_line(f"EVT_CASE_DEFAULT")
self.indent += 1
elif opcode == 0x1D:
self.indent -= 1
args_str = fix_1_arg(self, 0, self.var(argv[0]), SWITCH_TYPES[-1])
self.write_line(f"EVT_CASE_OR_EQ({args_str})")
self.indent += 1
elif opcode == 0x1E:
self.indent -= 1
args_str = fix_1_arg(self, 0, self.var(argv[0]), SWITCH_TYPES[-1])
self.write_line(f"EVT_CASE_AND_EQ({args_str})")
self.indent += 1
elif opcode == 0x1F:
self.indent -= 1
args_str = fix_1_arg(self, 0, self.var(argv[0]), SWITCH_TYPES[-1])
self.write_line(f"EVT_CASE_FLAG({args_str})")
self.indent += 1
elif opcode == 0x20:
self.indent -= 1
self.write_line(f"EVT_END_CASE_GROUP")
self.indent += 1
elif opcode == 0x21:
self.indent -= 1
self.write_line(f"EVT_CASE_RANGE({self.var(argv[0])}, {self.var(argv[1])})")
self.indent += 1
elif opcode == 0x22:
self.write_line(f"EVT_BREAK_SWITCH")
elif opcode == 0x23:
self.indent -= 2
del SWITCH_TYPES[-1]
self.write_line(f"EVT_END_SWITCH")
elif opcode == 0x24:
if self.var(argv[0]).startswith("LW"):
new_arg = trim_lw(self.var(argv[0]))
if self.var(argv[1]).startswith("LW"):
from_arg = trim_lw(self.var(argv[1])) # Carry type info of LW if being set from an LW
else:
from_arg = 0 # If a constant, we no longer know the type
LOCAL_WORDS[int(new_arg)] = LOCAL_WORDS[int(from_arg)]
self.write_line(f"EVT_SET({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x25:
argNum = argv[1]
sprite = (argNum & 0xFF0000) >> 16
palette = (argNum & 0xFF00) >> 8
anim = (argNum & 0xFF) >> 0
if sprite > 0:
value = make_anim_macro(self, sprite, palette, anim)
elif argNum > 100:
value = f"0x{argNum:08X}"
else:
value = f"{argNum}"
self.write_line(f"EVT_SET_CONST({self.var(argv[0])}, {value})")
elif opcode == 0x26:
self.write_line(f"EVT_SETF({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x27:
self.write_line(f"EVT_ADD({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x28:
self.write_line(f"EVT_SUB({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x29:
self.write_line(f"EVT_MUL({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x2A:
self.write_line(f"EVT_DIV({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x2B:
self.write_line(f"EVT_MOD({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x2C:
self.write_line(f"EVT_ADDF({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x2D:
self.write_line(f"EVT_SUBF({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x2E:
self.write_line(f"EVT_MULF({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x2F:
self.write_line(f"EVT_DIVF({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x30:
self.write_line(f"EVT_USE_BUF({self.var(argv[0])})")
elif opcode == 0x31 or opcode == 0x32 or opcode == 0x33 or opcode == 0x34:
args = [*map(self.var, argv)]
self.write_line(f"EVT_BUF_READ{opcode - 0x30}({', '.join(args)})")
elif opcode == 0x35:
args = [*map(self.var, argv)]
self.write_line(f"EVT_BUF_PEEK({', '.join(args)})")
elif opcode == 0x36:
self.write_line(f"EVT_USE_FBUF({self.var(argv[0])})")
elif opcode == 0x37 or opcode == 0x38 or opcode == 0x39 or opcode == 0x3A:
args = [*map(self.var, argv)]
self.write_line(f"EVT_FBUF_READ{opcode - 0x36}({', '.join(args)})")
elif opcode == 0x3B:
args = [*map(self.var, argv)]
self.write_line(f"EVT_FBUF_PEEK({', '.join(args)})")
elif opcode == 0x3C:
self.write_line(f"EVT_USE_ARRAY({self.var(argv[0])})")
elif opcode == 0x3D:
self.write_line(f"EVT_USE_FLAG_ARRAY({self.var(argv[0])})")
elif opcode == 0x3E:
self.write_line(f"EVT_MALLOC_ARRAY({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x3F:
self.write_line(f"EVT_BITWISE_AND({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x40:
self.write_line(f"EVT_BITWISE_AND_CONST({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x41:
self.write_line(f"EVT_BITWISE_OR({self.var(argv[0])}, 0x{argv[1]:X})")
elif opcode == 0x42:
self.write_line(f"EVT_BITWISE_OR_CONST({self.var(argv[0])}, 0x{argv[1]:X})")
elif opcode == 0x43:
func = self.addr_ref(argv[0])
args = [self.var(a, use_evt_ptr=True) for a in argv[1:]]
args_str = ", ".join(args)
args_str = replace_constants(self, func, args_str)
if func.startswith("evt_"):
# use func-specific macro
self.write_line(f"{func}({args_str})")
# Since the map ascii for map transitions is global, and several of them share the same RAM address,
# or ar not migrated, we have to create a placeholder
elif func == "GotoMap" or func == "GotoMapSpecial":
args = [self.var(a, use_evt_ptr=True) for a in argv[2:]]
args_str = ", ".join(args)
self.write_line(f"EVT_CALL({func}, EVT_PTR(UNK_STR_{argv[1]:X}), {args_str})")
elif args_str:
self.write_line(f"EVT_CALL({func}, {args_str})")
else:
self.write_line(f"EVT_CALL({func})") # no args
elif opcode == 0x44:
self.write_line(f"EVT_EXEC({self.addr_ref(argv[0])})")
elif opcode == 0x45:
self.write_line(f"EVT_EXEC_GET_TID({self.addr_ref(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x46:
self.write_line(f"EVT_EXEC_WAIT({self.addr_ref(argv[0])})")
elif opcode == 0x47:
args = [
self.addr_ref(argv[0]),
self.trigger(argv[1]),
self.collider_id(argv[2]),
*map(self.var, argv[3:]),
]
self.write_line(f"EVT_BIND_TRIGGER({', '.join(args)})")
elif opcode == 0x48:
self.write_line(f"EVT_UNBIND")
elif opcode == 0x49:
self.write_line(f"EVT_KILL_THREAD({self.var(argv[0])})")
elif opcode == 0x4A:
self.write_line(f"EVT_JUMP({self.var(argv[0])})")
elif opcode == 0x4B:
self.write_line(f"EVT_SET_PRIORITY({self.var(argv[0])})")
elif opcode == 0x4C:
self.write_line(f"EVT_SET_TIMESCALE({self.var(argv[0])})")
elif opcode == 0x4D:
self.write_line(f"EVT_SET_GROUP({self.var(argv[0])})")
elif opcode == 0x4E:
args = [
self.addr_ref(argv[0]),
self.trigger(argv[1]),
self.collider_id(argv[2]),
*map(self.var, argv[3:]),
]
self.write_line(f"EVT_BIND_PADLOCK({', '.join(args)})")
elif opcode == 0x4F:
self.write_line(f"EVT_SUSPEND_GROUP({self.var(argv[0])})")
elif opcode == 0x50:
self.write_line(f"EVT_RESUME_GROUP({self.var(argv[0])})")
elif opcode == 0x51:
self.write_line(f"EVT_SUSPEND_OTHERS({self.var(argv[0])})")
elif opcode == 0x52:
self.write_line(f"EVT_RESUME_OTHERS({self.var(argv[0])})")
elif opcode == 0x53:
self.write_line(f"EVT_SUSPEND_THREAD({self.var(argv[0])})")
elif opcode == 0x54:
self.write_line(f"EVT_RESUME_THREAD({self.var(argv[0])})")
elif opcode == 0x55:
self.write_line(f"EVT_IS_THREAD_RUNNING({self.var(argv[0])}, {self.var(argv[1])})")
elif opcode == 0x56:
self.write_line("EVT_THREAD")
self.indent += 1
elif opcode == 0x57:
self.indent -= 1
self.write_line("EVT_END_THREAD")
elif opcode == 0x58:
self.write_line("EVT_CHILD_THREAD")
self.indent += 1
elif opcode == 0x59:
self.indent -= 1
self.write_line("EVT_END_CHILD_THREAD")
else:
# unknown opcode
argv_str = ""
for arg in argv:
argv_str += ", "
argv_str += f"0x{arg:X}"
self.write_line(f"0x{opcode:02X}{argv_str}),")
def collider_id(self, arg):
if arg >= 0x4000 and arg <= 0x5000:
return f"EVT_ENTITY_INDEX({arg - 0x4000})"
else:
return self.var(arg)
class UnsupportedScript(Exception):
pass
if __name__ == "__main__":
import argparse
parser = argparse.ArgumentParser()
parser.add_argument("file", type=str, help="File to dissassemble from")
parser.add_argument("offset", help="Offset to start dissassembling from")
parser.add_argument(
"-end",
"-e",
"--e",
type=lambda x: int(x, 16),
default=0,
dest="end",
required=False,
help="End offset to stop dissassembling from.\nOnly used as a way to find valid scripts.",
)
parser.add_argument(
"-vram",
"-v",
"--v",
type=lambda x: int(x, 16),
default=0,
dest="vram",
required=False,
help="VRAM start will be tracked and used for the script output name",
)
parser.add_argument(
"-si",
"--si",
action="store_true",
default=False,
dest="si",
required=False,
help="Force si script output",
)
parser.add_argument(
"-blob",
"--b",
action="store_true",
default=False,
dest="blob",
required=False,
help="If there is a blob of scripts.",
)
args = parser.parse_args()
vram_base = args.vram
get_constants()
INCLUDED = {}
INCLUDED["functions"] = set()
INCLUDED["includes"] = set()
INCLUDES_NEEDED = {}
INCLUDES_NEEDED["include"] = []
INCLUDES_NEEDED["forward"] = []
INCLUDES_NEEDED["npcs"] = {}
INCLUDES_NEEDED["sprites"] = set()
try:
offset = int(args.offset, 0)
except ValueError:
info = sym_info.search_symbol(args.offset)
if info is None:
print(f"{args.offset} is not a valid symbol name")
exit(1)
offset = info[0]
if args.end > offset:
# Search the given memory range and report scripts
with open(args.file, "rb") as f:
gap = False
first_print = False
while offset < args.end:
f.seek(offset)
script = ScriptDisassembler(f, args.offset, {}, 0x978DE0, INCLUDES_NEEDED, INCLUDED)
try:
script_text = script.disassemble()
if script.instructions > 1 and "_EVT_CMD" not in script_text:
if gap and first_print:
potential_struct_sizes = {
"NpcData": 0x1F0,
"MobileAISettings": 0x30,
"NpcSettings": 0x2C,
"NpcGroupList": 0xC,
}
gap_size = offset - gap_start
potential_struct = "Unknown data"
potential_count = 1
for k, v in potential_struct_sizes.items():
if gap_size % v == 0:
potential_struct = k
potential_count = gap_size // v
print(
f"========== 0x{gap_size:X} byte gap ({potential_count} {potential_struct}?) 0x{gap_start:X} - 0x{offset:X} =========="
)
print()
gap = False
# print(f"EvtScript read from 0x{script.start_pos:X} to 0x{script.end_pos:X} "
# f"(0x{script.end_pos - script.start_pos:X} bytes, {script.instructions} instructions)")
# print()
vram = f"{args.vram:X}_" if vram_base > 0 else f""
script_text = script_text.replace(
"EvtScript script = SCRIPT({",
f"EvtScript N(D_{vram}{offset:X}) = " + "SCRIPT({",
)
print(script_text, end="")
print()
# print(f"Valid script found at 0x{offset:X}")
args.vram += script.end_pos - offset
offset = script.end_pos
first_print = True
else:
if not gap:
gap_start = offset
gap = True
offset += 4
args.vram += 4
except Exception:
if not gap:
gap_start = offset
gap = True
offset += 4
args.vram += 4
else:
with open(args.file, "rb") as f:
f.seek(offset)
loffset = args.offset
looping = 1
while looping:
try:
script = ScriptDisassembler(f, loffset, {}, 0x978DE0, INCLUDES_NEEDED, INCLUDED)
if args.si:
print(
ScriptDisassembler(f, loffset, {}, 0x978DE0, INCLUDES_NEEDED, INCLUDED).disassemble(),
end="",
)
else:
try:
script_text = script.disassemble()
# print(f"EvtScript read from 0x{script.start_pos:X} to 0x{script.end_pos:X} "
# f"(0x{script.end_pos - script.start_pos:X} bytes, {script.instructions} instructions)")
print()
print(script_text, end="")
except UnsupportedScript:
f.seek(offset)
print(ScriptDisassembler(f).disassemble(), end="")
break
except Exception as e:
print(e)
loffset = script.end_pos
LOCAL_WORDS = [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
looping = args.blob
try:
loffset = _script_lib[loffset - info[0] + info[2]][0][1]
except:
pass