TISAM — There Is Still A Mod
TISAM 仅通过官方下载渠道帮助整合包作者提醒玩家关于可选模组的信息。
抱歉!下一个版本被阻止了,因为所需的库正在开发中,等待通过 Modrinth 的审核。
✨ 简介
TISAM 是一款轻量级、合规友好的模组推荐器,专为 NeoForge 1.21.1 整合包设计。每次启动时,它会扫描玩家的 mods 文件夹,将已安装的 jar 文件与配置的 可选 模组列表进行比对——如果有缺失的模组,它会在标题屏幕上弹出一个小型、非侵入式的对话框,指引玩家前往官方下载页面。
TISAM 会链接到 Modrinth、CurseForge 或 GitHub 上模组作者的原始发布页面。玩家可以浏览缺失列表、查看每个模组的安装说明,或者通过 5 秒确认冷却期永久关闭该提示。
本模组专为希望在不违背许可协议和尊重玩家自主权的前提下提升模组可见性的整合包作者而构建。
? 模组详情
? 功能说明
每次游戏启动时,TISAM 会执行以下操作:
- 扫描
.minecraft/mods/ 目录,并根据你的 modules.json 中的 id 列表匹配 jar 文件名。
- 计算缺失集合 —— 即玩家尚未安装的推荐模组。
- 决定是否显示提示,采用三层过滤机制:
- 如果所有推荐模组都已安装?→ 静默处理。
- 如果玩家已确认“不再提醒”?→ 静默处理。
- 如果提醒衰减计时器到期?→ 静默处理。
- 否则 → 在标题屏幕显示一个小卡片作为首次提示。
- 渲染提示 UI,包含三个按钮:
- 查看模组 — 打开一个可滚动、可排序且带有徽章的列表。
- 稍后提醒 — 关闭;增加衰减计数器。
- 不再提醒 — 打开免责声明(需 5 秒冷却),然后才提交更改。
?️ 特性
- ? 基于文件名的检测 — 无需解析清单或加载类;轻量且兼容不同版本(
sodium-0.5.0.jar、Sodium-0.6.0-mc1.21.1.jar 等均可匹配 id: "sodium")。
- ? 三步游戏内流程 — 简洁提示 → 可滚动列表 → 带自定义说明的可折叠安装指南。
- ⏱️ 基于衰减的提醒频率 —
reminder_frequency: [1, 1, 3, 3, 3, 7, 7, 7, 7, 15](每次启动 → 每 3 次启动 → 每 7 次 → 每 15 次),可按整合包配置。
- ?️ 优先级标签 —
featured ★、critical ⚠、normal、optional ↓,支持排序、彩色边框和标签显示。
- ?️ “不再提醒”免责声明的 5 秒确认冷却 — 防止误触。
- ? 公共 API —
com.tisam.api.TisamApi,供其他模组与 TISAM 集成使用。
- ⌨️ 客户端命令 —
/tisam show | preview | reset,可用于 FancyMenu 按钮和调试。
- ? 预览模式 —
"preview": true 会在每次启动时强制显示提示,用于整合包作者的预览测试,采用纯内存点击处理(在整合包作者测试期间不写入磁盘)。
- ? 本地数据 — 所有内容均存储在
config/tisam/preferences.json 中;零网络调用。
? 配置
config/tisam/modules.json:
{
"modules": [
{
"id": "sodium",
"name": "Sodium",
"description": "现代渲染引擎,大幅提升 FPS。",
"license": "LGPL-3.0",
"url": "https://modrinth.com/mod/sodium",
"can_ignore": true,
"priority": "critical"
}
],
"reminder_frequency": [1, 1, 3, 3, 3, 7, 7, 7, 7, 15],
"install_guide_text": "...",
"disclaimer_text": "...",
"preview": false
}
config/tisam/preferences.json(由 TISAM 自动管理):
{
"permanently_skipped": false,
"reminder_count": 0,
"last_reminder_date": ""
}
? 快速开始
玩家:
- 将
There-Is-Still-A-Mod-1.0.0.jar 放入 .minecraft/mods/ 目录。
- 启动一次游戏,TISAM 会自动在
.minecraft/config/tisam/ 下生成配置文件。
- 重启游戏。如果你的整合包作者配置了任何推荐模组,提示将会出现。
整合包作者:
- 将 TISAM 的 jar 文件包含在你的整合包中。
- 提供一个预填充好的
config/tisam/modules.json,列出你推荐的可选模组。
- 在制作过程中设置
"preview": true,发布前将其改为 false。
- (可选)在你的整合包描述中添加合规声明。
? 合规声明
TISAM 采用 Apache-2.0 许可证授权。它仅分发自身的字节码;所有推荐模组文件仍归原作者所有。提示 UI 中的所有外部链接均指向模组作者的官方发布页面。
分发包含 TISAM 的整合包作者应在其整合包描述的任何位置添加以下内容:
本整合包使用 TISAM (或 There Is Still A Mod) 来下载可选模组。
? 要求
无,除了游戏本体和 NeoForge 本身外无需其他依赖。
你可以将此模组包含在整合包中
TISAM — There Is Still A Mod
TISAM helps modpack authors remind players about optional mods through official download channels only.
Sorry! The further version is blocked because a required lib devoloping now is waiting to pass the moderation of modrinth.
✨ Introduction
TISAM is a lightweight, compliance-friendly mod recommender for NeoForge 1.21.1 modpacks. On every launch, it scans the player's mods folder, compares the installed jars against a configured list of optional mods, and — when something is missing — opens a small, non-intrusive dialog on the title screen pointing the player to the official download page.
TISAM links out to mod authors' original release pages on Modrinth, CurseForge, or GitHub. The player can browse the missing list, view per-mod install instructions, or permanently dismiss the prompt with a 5-second confirmation cooldown.
Built for modpack authors who want a discoverability layer that respects both licensing and player agency.
? Mod Details
? What It Does
On every game launch, TISAM:
- Scans
.minecraft/mods/ and matches jar filenames against your modules.json id list.
- Computes the missing set — the recommended mods the player hasn't installed yet.
- Decides whether to show the prompt using a three-layer gate:
- Is every recommended mod already installed? → silent.
- Has the player confirmed "Never Remind Again"? → silent.
- Is the reminder decay timer due? → silent.
- Otherwise → show a small first-prompt card on the title screen.
- Renders the prompt UI with three buttons:
- View Mods — opens a scrollable, sortable list with badges.
- Later Reminder — closes; increments the decay counter.
- Never Remind Again — opens a disclaimer (5s cooldown) before committing.
?️ Features
- ? Filename-based detection — no manifest parsing, no class-loading; lightweight and version-tolerant (
sodium-0.5.0.jar, Sodium-0.6.0-mc1.21.1.jar, etc. all match id: "sodium").
- ? Three-step in-game flow — concise prompt → scrollable list → collapsible install guide with custom instructions.
- ⏱️ Decay-based reminder frequency —
reminder_frequency: [1, 1, 3, 3, 3, 7, 7, 7, 7, 15] (every launch → every 3 launches → every 7 → every 15) configurable per modpack.
- ?️ Priority tags —
featured ★, critical ⚠, normal, optional ↓ with sort order, color borders, and labels.
- ?️ 5-second confirmation cooldown on the "Never Remind Again" disclaimer — prevents mis-clicks.
- ? Public API —
com.tisam.api.TisamApi for other mods to integrate with TISAM.
- ⌨️ Client command —
/tisam show | preview | reset for FancyMenu buttons and debugging.
- ? Preview mode —
"preview": true forces the prompt on every launch for modpack-author previews, with in-memory-only click handling (writes nothing to disk while the modpack author is testing).
- ? Local-only data — everything lives in
config/tisam/preferences.json; zero network calls.
? Configuration
config/tisam/modules.json:
{
"modules": [
{
"id": "sodium",
"name": "Sodium",
"description": "Modern rendering engine, dramatically better FPS.",
"license": "LGPL-3.0",
"url": "https://modrinth.com/mod/sodium",
"can_ignore": true,
"priority": "critical"
}
],
"reminder_frequency": [1, 1, 3, 3, 3, 7, 7, 7, 7, 15],
"install_guide_text": "...",
"disclaimer_text": "...",
"preview": false
}
config/tisam/preferences.json (auto-managed by TISAM):
{
"permanently_skipped": false,
"reminder_count": 0,
"last_reminder_date": ""
}
? Quick Start
Players:
- Drop
There-Is-Still-A-Mod-1.0.0.jar into .minecraft/mods/.
- Launch once and TISAM auto-generates the config files under
.minecraft/config/tisam/.
- Restart. The prompt will appear if your modpack author configured any recommended mods.
Modpack Authors:
- Include the TISAM jar in your modpack.
- Ship a pre-filled
config/tisam/modules.json listing your recommended optional mods.
- Set
"preview": true while authoring, then flip it to false for release.
- (Optional) Add the compliance statement to your modpack description.
? Compliance Statement
TISAM is licensed under Apache-2.0. It ships only its own bytecode; all recommended-mod files stay with their original authors. Every external link in the prompt UI points to the mod author's official release page.
Modpack authors shipping TISAM should add this to their modpack description (in any places) :
This modpack uses TISAM (or There Is Still A Mod) for downloading optional mods.
? Requirements
no, instead of game itself and neoforge
You could include this mod in modpack
评论 0
登录后参与评分
还没有评论,来抢沙发吧