summaryrefslogtreecommitdiff
path: root/docs/src/en/guide/admin/cache.md
diff options
context:
space:
mode:
authorSho Sakuma <me@m1sk9.dev>2026-01-24 05:01:27 +0900
committerGitHub <noreply@github.com>2026-01-24 05:01:27 +0900
commite3387a401c6d0d094b3afa734558e9257465a42b (patch)
tree4202c404fc72249f117162a37a573bcec274d555 /docs/src/en/guide/admin/cache.md
parentac80dc3ce71f9be0397442208cac80f6069eea03 (diff)
parentf6b0baf90c20a1d3b0cd53629102883b4bd913c6 (diff)
downloadLunaticChat-0.5.0.tar.gz
LunaticChat-0.5.0.tar.bz2
LunaticChat-0.5.0.zip
Merge pull request #65 from m1sk9/chore/release-beta-stagev0.5.0
chore: Release to beta stage
Diffstat (limited to 'docs/src/en/guide/admin/cache.md')
-rw-r--r--docs/src/en/guide/admin/cache.md41
1 files changed, 41 insertions, 0 deletions
diff --git a/docs/src/en/guide/admin/cache.md b/docs/src/en/guide/admin/cache.md
new file mode 100644
index 0000000..2fa2802
--- /dev/null
+++ b/docs/src/en/guide/admin/cache.md
@@ -0,0 +1,41 @@
+# Cache System
+
+LunaticChat includes a system that automatically caches phrases from Japanese romanization conversion to both memory and disk.
+
+For information on Japanese romanization conversion, see [here](../player/japanese-romanization.md).
+
+## Memory Cache
+
+LunaticChat caches converted phrases in memory, allowing for fast responses when the same phrase is requested again.
+
+This cache is temporary and is saved to disk cache at server restart or at configured intervals.
+
+## Disk Cache
+
+LunaticChat periodically saves the contents of the memory cache to disk. This allows the cache contents to be retained even after server restarts.
+
+The file used for disk cache can be [changed in the configuration](configuration.md#cachefilepath).
+
+## Cache Release
+
+Memory cache is automatically released by the JVM's garbage collection after being cached to disk.
+
+Disk cache can be released by manually deleting the file. LunaticChat will recreate the cache file on restart.
+
+::: warning About Purge Functionality
+
+LunaticChat does not implement a cache purge feature.
+
+This is because allowing players to manipulate the host's file system is not desirable from a security perspective.
+
+:::
+
+## Cache Version
+
+The file used for disk cache includes a `version` field, which handles changes to the cache format due to LunaticChat version updates.
+
+If the version does not match, LunaticChat recognizes the cache file as **an old format cache**, ignores its contents, and recreates it in the new format.
+
+```json
+{"version":"1","entries":{}}
+```