226 lines
7.5 KiB
Python
226 lines
7.5 KiB
Python
"""Install / uninstall TLInspector into an RPG Maker MV or MZ game folder.
|
|
|
|
Credits: Idea by Sakura · Plugin by Kao_SSS
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import re
|
|
from pathlib import Path
|
|
|
|
PLUGIN_NAME = "TLInspector"
|
|
PLUGIN_ENTRY = (
|
|
' { "name": "TLInspector", "status": true, '
|
|
'"description": "TL source inspector", "parameters": {} }'
|
|
)
|
|
|
|
_PKG_ROOT = Path(__file__).resolve().parent
|
|
DEFAULT_PLUGIN_SRC = _PKG_ROOT / "TLInspector.js"
|
|
|
|
|
|
def bundled_plugin_path() -> Path:
|
|
return DEFAULT_PLUGIN_SRC
|
|
|
|
|
|
def detect_engine(game_root: Path) -> tuple[str, Path, Path] | None:
|
|
"""Return (engine, plugins_js, plugins_dir) or None if not MV/MZ."""
|
|
root = Path(game_root)
|
|
mv_js = root / "www" / "js" / "plugins.js"
|
|
mz_js = root / "js" / "plugins.js"
|
|
if mv_js.is_file():
|
|
return "MV", mv_js, root / "www" / "js" / "plugins"
|
|
if mz_js.is_file():
|
|
return "MZ", mz_js, root / "js" / "plugins"
|
|
return None
|
|
|
|
|
|
def _read_plugins_js(plugins_js: Path) -> tuple[str, str]:
|
|
content = plugins_js.read_text(encoding="utf-8")
|
|
nl = "\r\n" if "\r\n" in content else "\n"
|
|
return content, nl
|
|
|
|
|
|
def _is_declared(content: str) -> bool:
|
|
return bool(re.search(r'"name"\s*:\s*"TLInspector"', content))
|
|
|
|
|
|
def _has_remnants(content: str) -> bool:
|
|
return bool(
|
|
re.search(
|
|
r'"description"\s*:\s*"TL source inspector"',
|
|
content,
|
|
)
|
|
)
|
|
|
|
|
|
def _find_plugin_block_span(content: str, plugin_name: str = PLUGIN_NAME) -> tuple[int, int] | None:
|
|
"""Return [start, end) span of the plugin object in plugins.js, or None."""
|
|
m = re.search(rf'"name"\s*:\s*"{re.escape(plugin_name)}"', content)
|
|
if not m:
|
|
return None
|
|
start = content.rfind("{", 0, m.start())
|
|
if start < 0:
|
|
return None
|
|
depth = 0
|
|
for i in range(start, len(content)):
|
|
ch = content[i]
|
|
if ch == "{":
|
|
depth += 1
|
|
elif ch == "}":
|
|
depth -= 1
|
|
if depth == 0:
|
|
end = i + 1
|
|
while end < len(content) and content[end] in " \t\r\n":
|
|
end += 1
|
|
if end < len(content) and content[end] == ",":
|
|
end += 1
|
|
return start, end
|
|
return None
|
|
|
|
|
|
def _remove_plugin_block(content: str, plugin_name: str = PLUGIN_NAME) -> str:
|
|
compact = rf"\{{[^{{}}]*\"name\"\s*:\s*\"{re.escape(plugin_name)}\"[^{{}}]*\}}\s*,?"
|
|
content = re.sub(compact, "", content)
|
|
while True:
|
|
span = _find_plugin_block_span(content, plugin_name)
|
|
if span is None:
|
|
break
|
|
start, end = span
|
|
before = content[:start].rstrip()
|
|
after = content[end:].lstrip()
|
|
if before.endswith(","):
|
|
before = before[:-1].rstrip()
|
|
elif after.startswith(","):
|
|
after = after[1:].lstrip()
|
|
gap = "\n" if before and after and not before.endswith("\n") else ""
|
|
content = before + gap + after
|
|
lines = [
|
|
line
|
|
for line in re.split(r"\r?\n", content)
|
|
if not re.search(rf"\"name\"\s*:\s*\"{re.escape(plugin_name)}\"", line)
|
|
]
|
|
content = "\n".join(lines)
|
|
# Leftover fragments from a previously corrupted multi-line entry.
|
|
content = re.sub(
|
|
r",\s*\{\s*\"status\"\s*:\s*true\s*,\s*\"description\"\s*:\s*\"TL source inspector\""
|
|
r"\s*,\s*\"parameters\"\s*:\s*\{[^{}]*\}\s*\}",
|
|
"",
|
|
content,
|
|
)
|
|
content = re.sub(
|
|
r"\{\s*\"status\"\s*:\s*true\s*,\s*\"description\"\s*:\s*\"TL source inspector\""
|
|
r"\s*,\s*\"parameters\"\s*:\s*\{[^{}]*\}\s*\}\s*,?",
|
|
"",
|
|
content,
|
|
)
|
|
return content
|
|
|
|
|
|
def status(game_root: Path) -> dict:
|
|
"""Return install state for the game folder."""
|
|
info = detect_engine(game_root)
|
|
if info is None:
|
|
return {
|
|
"ok": False,
|
|
"engine": None,
|
|
"installed": False,
|
|
"declared": False,
|
|
"plugin_file": None,
|
|
"message": "No RPG Maker MV/MZ game found (missing plugins.js).",
|
|
}
|
|
engine, plugins_js, plugins_dir = info
|
|
target = plugins_dir / f"{PLUGIN_NAME}.js"
|
|
content, _ = _read_plugins_js(plugins_js)
|
|
declared = _is_declared(content)
|
|
file_there = target.is_file()
|
|
return {
|
|
"ok": True,
|
|
"engine": engine,
|
|
"installed": declared or file_there,
|
|
"declared": declared,
|
|
"plugin_file": file_there,
|
|
"plugins_js": str(plugins_js),
|
|
"target": str(target),
|
|
"message": (
|
|
"Installed"
|
|
if declared and file_there
|
|
else "Partially installed"
|
|
if declared or file_there
|
|
else "Not installed"
|
|
),
|
|
}
|
|
|
|
|
|
def install(game_root: Path, source_js: Path | None = None, cfg: dict | None = None) -> tuple[bool, str]:
|
|
"""Copy TLInspector.js into the game and declare it in plugins.js."""
|
|
from util.tl_inspector.config import load_config, prepare_plugin_js
|
|
|
|
info = detect_engine(game_root)
|
|
if info is None:
|
|
return False, "No RPG Maker MV/MZ game found at that path."
|
|
|
|
engine, plugins_js, plugins_dir = info
|
|
src = Path(source_js) if source_js else DEFAULT_PLUGIN_SRC
|
|
if not src.is_file():
|
|
return False, f"TLInspector.js not found: {src}"
|
|
|
|
target = plugins_dir / f"{PLUGIN_NAME}.js"
|
|
content, nl = _read_plugins_js(plugins_js)
|
|
|
|
plugins_dir.mkdir(parents=True, exist_ok=True)
|
|
effective_cfg = cfg if cfg is not None else load_config()
|
|
target.write_text(prepare_plugin_js(src, effective_cfg), encoding="utf-8")
|
|
|
|
if not _is_declared(content):
|
|
idx = content.rfind("];")
|
|
if idx < 0:
|
|
return False, "Could not find plugin list end ( ]; ) in plugins.js."
|
|
before = content[:idx].rstrip()
|
|
after = content[idx:]
|
|
sep = nl if before.endswith(",") else "," + nl
|
|
content = before + sep + PLUGIN_ENTRY + nl + " " + after
|
|
plugins_js.write_text(content, encoding="utf-8", newline="")
|
|
|
|
return True, (
|
|
f"TLInspector installed for RPG Maker {engine}. "
|
|
f"Press {(cfg or {}).get('hotkey', 'F9')} in-game to open."
|
|
)
|
|
|
|
|
|
def uninstall(game_root: Path) -> tuple[bool, str]:
|
|
"""Remove TLInspector from plugins.js and delete the plugin file."""
|
|
info = detect_engine(game_root)
|
|
if info is None:
|
|
return False, "No RPG Maker MV/MZ game found at that path."
|
|
|
|
_, plugins_js, plugins_dir = info
|
|
target = plugins_dir / f"{PLUGIN_NAME}.js"
|
|
content, _ = _read_plugins_js(plugins_js)
|
|
|
|
if _is_declared(content) or _has_remnants(content):
|
|
content = _remove_plugin_block(content)
|
|
content = re.sub(r",(\s*)\];", r"\1];", content)
|
|
plugins_js.write_text(content, encoding="utf-8", newline="")
|
|
|
|
if target.is_file():
|
|
target.unlink()
|
|
|
|
return True, "TLInspector uninstalled."
|
|
|
|
|
|
def apply_config(game_root: Path, cfg: dict | None = None) -> tuple[bool, str]:
|
|
"""Rewrite an installed TLInspector.js with current editor settings."""
|
|
from util.tl_inspector.config import load_config, prepare_plugin_js
|
|
|
|
info = detect_engine(game_root)
|
|
if info is None:
|
|
return False, "No RPG Maker MV/MZ game found at that path."
|
|
|
|
_, _, plugins_dir = info
|
|
target = plugins_dir / f"{PLUGIN_NAME}.js"
|
|
if not target.is_file():
|
|
return False, "TLInspector is not installed in this game folder."
|
|
|
|
effective_cfg = cfg if cfg is not None else load_config()
|
|
target.write_text(prepare_plugin_js(DEFAULT_PLUGIN_SRC, effective_cfg), encoding="utf-8")
|
|
return True, "TL Inspector editor settings applied to the installed plugin."
|