Chinese tutorial
https://www.bilibili.com/read/cv5916825
You can use translation software to read, maybe

End-game video
Old: https://www.bilibili.com/video/BV1dV411R7LE/
New: https://www.bilibili.com/video/BV15f4y1v7oM/
(The entire process of using the addon was recorded)

Simple example video
https://www.bilibili.com/video/BV16a4y1L7H9/

The interface description is a little bit more detailed
更新汉化

Update:
V2.3.0
fix bug
修复bug
Improve the equipment management system
完善装备管理系统
Judging the conditions of the kill can now be used in scoring systems
过时的斩杀判断条件，现在可以用于打分系统
Added conditions for judging the difference in relative values, such as acc to def
添加了判断相对数值差的条件，例如命中之于闪避
Special judgments can be made to determine whether they are close to unsafe places
特殊判断里可以判断是否靠近不安全的地点
V2.2.13
Conditional judgment, which adds a skill level judgment
条件判断，添加了技能等级的判断
V2.2.11
Fixed several bugs in the SaveSyS
存档系统修复了几个bug
Equipment filter system added collecting breath
装备收集添加了收集呼吸装备
V2.2.7
Added a random grid, which allows you to set the nearest and furthest random distances, in order to use talents that require targets when not in combat, such as NEC's Summon skull
增加了一个技能释放方式 —— 随机格子，可以设置最近最远随机距离，主要是为了在非战斗状态下使用一些需要目标的技能，例如NEC的召唤骷髅
V2.2.4
AutoTimer adds a special timer "StopRest" that will StopRest when it is present
计时器 添加特殊计时器“StopRest”，当有它的时候会停止休息
The command team skill has been modified, when you order it to "anchor", its "anchor distance" is changed to 1, when you order it to target an enemy, its "anchor distance" is changed to 100
指挥队友的技能做了修改，当你命令它“抛锚”时，它的“抛锚距离”会被修改成1，当你命令它以敌人为目标时，他的“抛锚距离”会被修改成100

V2.2.0
Add equipment filtering system, the button is in the upper right corner, after entering the middle of the HELP button to explain how to use. If you don't want to Filter the scores, you can do some simple filtering on the Filter button. After filtering is enabled, in the equipment view interface, you can get two ways to view equipment, one is to view the equipment combat attributes (but needs to score support), the other is to view the attributes of the equipment. After all, with this little system, you can filter out most of the junk you don't want to look at.
新增装备过滤系统，按钮在右上角，进入后中间有帮助按钮说明使用方式。不想进行打分过滤，也能在过滤按钮进行一些简单的过滤。开启过滤后，在装备查看界面，能获得2种装备查看方式，一种查看装备战斗属性（但是需要打分支持），另一种则是查看加属性的装备。总之使用这个小系统，可以筛选掉大部分你看都不想看一眼的废物装备。
The equipment interface to view gems, provides a selling function, selling gems is no longer a headache.
装备界面查看宝石，提供了一个贩卖功能，贩卖宝石不再是头疼的问题。
A simple change to SimpleAI, which defaults to 0 as a command for all teammates. (Also, probably not many people have used it, because it tells the AI who to target based on the player's point of view, for example "all enemies" are enemies close to the player, so)
简单修改了一下简单AI，默认值为0时视为命令所有队友。（另外可能没啥人用过，这个功能命令AI以谁为目标时，是以玩家的视角为准，例如“所有敌人”是距离玩家近的敌人）
In the SimpleAI interface, there is an option to learn a skill, which makes it very convenient to command your teammates to fight, tell them who to attack or where to move (of course moving actually means "anchoning" to a certain location). Of course, you can't command what you can't command.
简单AI界面中，添加了一个选项可以学习一个技能，可以非常方便的指挥队友战斗，命令它们攻击谁或者移动到哪里（当然实际上移动就是“抛锚”到某个位置）当然你并不能命令不能命令的事物。
AI tactical talents，added an option to turn off all skills that are not set at once
AI技能策略，添加了一个选项，可以关闭所有一次也没有设置的技能
- Added another movement skill, which is different from the previous movement skill, to solve the problem of not being able to find the path due to vision problems, such as the rogues who have no light but can see an enemy in the dark distance.
添加了另一个移动技能，和之前的移动技能有所不同，是为了解决因为视野问题导致无法寻路的问题，例如盗贼没有光照但是却可以看见黑暗的远方有个敌人 。

v2.0.5
In the game, if you open the edit panel to update the function, you will not report an error. The bug of judging skill conditions has been fixed (now the release conditions of the same skill in and out of combat will no longer interfere with each other)
游戏中打开编辑面板更新函数就不会报错了，修复了技能条件判断的bug（现在同一个技能战斗中战斗外的释放条件不再会互相干扰）
v2.0.0
This time, some things have been updated and the previous code structure has been changed. It should be the first and last time
这一次更新更新了一些东西，动了以前的代码结构，应该是第一次也是最后一次动结构了
Therefore, to use version 2.0.0, a new game must be opened, and the old game must use the previous version
因此使用2.0.0版本必须开新档，旧档必须用以前的版本

The content of this update is still in the video link, starting from p23
这次更新的内容依然在这个视频链接中，从P23开始演示
https://www.bilibili.com/video/BV16a4y1L7H9/
v1.1.0
Improve automatic combat and automatic Z, and add "duration of armistice determination" to be set
改善自动战斗和自动Z，设置增加“停战判定的持续时间”可以设定
v1.0.7
Quick setting to turn on SuS talent during resting
休息时开启持续技能的快捷设置
Z ignores special terrain
Z无视特殊地形
restCD default 100~100, but 1~100 if CD>xx (default 30)
休息CD默认100~100，但是如果CD大于xx（默认30）就会默认设置1~100
v1.0.5
Right talent can see THE ID, but also can switch automatically; An option to disable Auto Combat and Auto Z has been added to the panel; Automatic Z is no longer forced, and stopping is much easier
右键技能可以查看id，同时也能开关自动；面板中上多了个关闭自动战斗和自动Z的选项；自动Z不再有强迫性，停下来轻松多了

Wanderer now choose one in three random talent trees instead.

Modifies the character creation dialog to bypass the lock check for campaigns and difficulty levels, allowing characters to play campaigns and difficulty levels that you haven't unlocked. Doesn't actually unlock anything.

Allows you to choose which escorts you will encounter at the start of the game.
You may change the future encounters in the game menu (Esc).

There is an option to choose a random escort in case you just wanted to guarantee some unlocks before continuing with the base game's behavior.

Note: You're only supposed to be able to choose the lost tinker once. (Must have the Embers of Rage DLC and unlocked by playing in the Orcs campaign)
Note: Unfortunately the only time that addons can get the possible escort types is after the random escort quest is assigned.
This means escorts added by other addons will not be available for selection, but will still be possible to find using the random selection.

To reach me faster, please leave a message on the Steam Workshop page. I don't get notifications on te4.org so I may take longer to reply.

1. English Version (Condensed)

1. Faster ToME4 (v0.2.8) — Release Notes

Comprehensive performance & stability overhaul for **ToME 1.7.6** (Upstream: 0.0.1).

> **TL;DR**: Synchronous save pause reduced by **~68%** (459 ms → 145 ms); pure Lua FBO guard eliminates mid-frame rendering stalls; native memory leaks fixed. **100% pure Lua, zero external binaries, fully compatible with existing saves & achievements.**

1. 1. Save Stutter Reductions
1. Fast Snapshot Clone**: Skips memo lookups for primitive values; cuts cloning CPU time by **~33%** while preserving the exact object graph.
2. Wait-Screen Refresh**: Pumps native wait-screen redraws during snapshot cloning; reduces save-time freezes from **171.4 ms to 70.5 ms (-58.9%)**.
3. Fast Lossless Screenshots**: Direct GL pixel reads with Level-1 PNG compression; cuts screenshot capture time from **50.0 ms to 24.3 ms (-51.5%)**.
4. Redundant Work Eliminated**: Omitted unused secondary party creation and offline character dumps, saving 1,700+ transient UID allocations and ~136 RNG calls per save.

1. Rendering & Combat Smoothness
1. Pure Lua FBO GC Guard**: Fixes engine defect where FBO finalizers corrupt active drawing targets mid-frame; defers cleanup to the next `use()` call, eliminating driver/LLVM stalls.
2. Hit-Warning Rate Limiting**: Throttles directional arrows (`hit_warning`) to **1 per 500 ms**; prevents arrow volleys from flooding emitters and lagging the game.
3. UI & Mask Batching**: Caches hotkey text rasterization (**-23.6%** display CPU); batches effect-mask geometry into single vertex calls.

1. Engine & Upstream Bug Fixes
1. Native Memory Leak Fixed**: Switched character export compressor to embedded `lzlib` with proper cleanup, eliminating **~12.8 MiB leak per 50 exports**.
2. Log & Cache Hardening**: Fixed `CacheList` modulo bug (now utilizes all 5,000 slots); restored `truncate_printlog`; bounded chat text & bytecode caches.
3. Particle Leaks Fixed**: Added finite lifetimes to `notice_enemy` and `dreamhammer` emitters that previously leaked indefinitely.

1. 4. Optional Settings (`config.settings.faster_tome.*`)

All enabled by default. Toggles include: `fbo_gc_guard`, `hit_warning_interval_ms` (0 to disable), `snapshot_refresh`, `screenshot_png`, `save_clone`, `offline_chardump`, `unused_party_cleanup`, `export_gzip`.

---

1. 中文版（精简版）

1. Faster ToME4 (v0.2.8) — 版本更新说明

适配 **ToME 1.7.6** 的全面性能与稳定性大版本（对比上游基准：0.0.1）

> **核心摘要**：存盘主线程卡顿减少 **~68%**（459 ms → 145 ms），告别存盘假死；纯 Lua FBO 保护消除渲染卡顿与绘制错乱；根治多处内存泄漏。**全插件纯 Lua 实现，零 C 扩展依赖，100% 兼容原版存档、成就与规则。**

1. 1. 存盘卡顿深度优化
1. 快照浅克隆提速**：基础类型跳过哈希查表，对象图 100% 一致的前提下纯克隆 CPU 耗时减少 **~33%**。
2. 存盘画面定期刷新**：同步快照期间定期刷新原生等待条与界面，最大停顿时间从 **171.4 ms 降至 70.5 ms（-58.9%）**，不再白屏假死。
3. 极速无损截图**：底层像素直读 + 1 级无损 PNG 编码，截图耗时从 **50.0 ms 降至 24.3 ms（耗时减半）**。
4. 冗余流程彻底剔除**：省去未使用的临时导出队伍克隆与离线角色卡序列化，单次存盘省去 1,700+ 临时 UID 与约 136 次随机数消耗。

1. 2. 渲染与战斗流畅优化
1. 纯 Lua FBO 回收保护**：修复引擎原生 FBO 析构重置绘制目标导致后续掉帧的缺陷，延后至下次 `use()` 统一安全释放，消除驱动重编译与长帧。
2. 受击提示限速**：远程受击箭头默认 **500 ms 冷却节流**，杜绝多重箭雨或高频连击瞬间刷爆粒子导致的严重顿卡与视效干扰。
3. 界面与特效合批**：快捷栏文字光栅化缓存（绘制 CPU **减少 23.6%**），地图效果遮罩改为顶点数组批量绘制。

1. 3. 上游缺陷与内存泄漏修复
1. 根治导出原生内存泄漏**：改用引擎内置 `lzlib` 并严格释放流状态，彻底消除每 50 次角色导出约 **12.8 MiB** 的原生堆内存常驻泄漏。
2. 日志与缓存加固**：修正 `CacheList` 模运算差一错误（用满全部 5,000 槽位），恢复日志截断功能，加固聊天框与字节码缓存上限。
3. 终结粒子常驻泄漏**：修复 `notice_enemy` 与 `dreamhammer` 粒子发射后在后台永久空转的缺陷。

1. 4. 独立开关配置（`config.settings.faster_tome.*`）

全部优化默认开启。需要时可在配置中独立调整：`fbo_gc_guard`（FBO保护）、`hit_warning_interval_ms`（受击间隔，0为不限速）、`snapshot_refresh`（快照刷新）、`screenshot_png`（极速截图）、`save_clone`（克隆加速）、`offline_chardump`（跳过离线导出）、`unused_party_cleanup`（跳过临时队伍）、`export_gzip`（无泄漏压缩）。

Not all adventurers seek fortune, not all that defend the world have good deeds in mind.
Lately the number of sightings of horrors have grown tremendously. People wander off the beaten paths only to be found years later, horribly mutated and partly insane, if they are found at all. It is becoming evident something is stirring deep below Maj'Eyal.
That something is you.

Forbidden Cults is a big expansion for Tales of Maj'Eyal to let you explore the horrors that lurk beneath the surface, to delve in long lost knowledge and lore and as usual to die a lot!

Forbidden Cults makes two new classes available to play:

• Writhing One: Give in to the corrupting forces and turn yourself gradually into an horror, summon horrors to do your bidding, shed your skin and melt your face to assault your foes. With your arm already turned into a tentacle, what creature can stop you?
• Cultist of Entropy: Using its insanity and control of entropic forces to unravel the normal laws of physic this caster class can turn healing into attacks and call upon the forces of the void to reduce its foes to dust.

Both those classes use a new resource called Insanity that gradually makes you both more chaotic and powerful as it fills up.

Forbidden Cults makes two new races available to play:

• Drem: A corrupt subrace of dwarves, that somehow managed to keep a shred of sanity to not fully devolve into mindless horrors. They can enter a frenzy and even learn to summon horrors.
• Krog: Ogres transformed by the very thing that should kill them. Their powerful attacks can stun their foes and they are so strong they can dual wield any one handed weapons.

Forbidden Cults adds many new zones for you to explore and die in:

• Kroshkkur: An ancient Sher'tul Fortress laying half in ruins that serves as a focal point, and home, for all kinds of creatures seeking lost knowledge.
• The Maggot: A huge living corrupted worm about to destroy Kroshkkur! Teleport inside and save your sanctuary of horrors!
• The Godfeaster: Deep undergroud the ground shakes as ... -- redacted by corrupt forces --
• The Scourge Pits: On the south of the Iron Throne lays a fool pit of ... -- redacted by corrupt forces --
• Forbidden Tomes: Find special artifact books of ancient lore. But, read at your own peril, for the story they tell may very well suck you in... quite literally.
  Maybe you will even find The One That Writes...
• Occult Egress: A strange, extremely old, contraption of unknown origin. It seems to require some kind of code sequence to activate. Maybe you will find some during your adventures?
• The Entropic Void: So you think you are strong? Powerful? Invulnerable? In the end, entropy always wins, as you will learn...

What would an expansion about horrors be without a bunch of new horrors to torment you with? Please give a warm welcome to:

• Searing Horrors: You liked luminous horrors? You loved radiant horrors? You will absolutely adore their searing big brothers!
• Nethergates: It sleeps. Maybe it should stay that way.
• Netherworms: Vampiric worm masses that are bound to tickle your fancy! And tickle hard.
• Fearful Symmetry: Geometry has never been so lively!
• Entropic Shards: Take an entropic crystal, shatter it with tentacles. And die.
• : And more ...

"DarkGod, is that all?" Obviously not! You will also find your usual addition of:

• Lore: Delve into the dark forgotten secrets of the world, where sanity is a very tenuous idea.
• Artifacts: Discover new objects of power and use them to further your own goals.
• New wyrmic tree: Unlock the scourge drake for your wyrmics.
• Glass Golem: Unlock the glass golem option for your alchemists.
• Events: Discover new strange contraptions in familiar zones. What could go wrong?
• Achievements: Because there can never be enough!