跳到正文

Discord Logs

作者:DanielBasov

Optional, consent-based client log collection for Discord support, with authenticated delivery for Steam & Steel servers.

收藏

介绍

中文介绍正在准备中,下面暂时显示原文。

Discord Logs

Collect recent Minecraft logs for Discord support after the player gives permission. A saved choice enables background uploads, so a player can attach already collected logs when reporting a problem.

Current beta editions

Version 1.1.2 adds the current private Discord integration panel in the player passport while retaining consent-based log collection. It remains a Steam & Steel service integration with a separately configured authenticated backend. Publication of this JAR does not deploy that backend. Original mod/network identifiers, collection/redaction policy and dependency declarations are preserved. The existing log-collection workflow is documented below.

The companion client file 1.1.3 adds /sslogs status and consent-respecting /sslogs retry, separate save/read/network/HTTP failure reasons, safe request IDs and bounded retries. It preserves collection/redaction/consent and the common wire implementation used by server 1.1.2. Native client/backend checks are recorded; a real updated player consent/upload/status flow remains unverified. Use client 1.1.3 with the matching server 1.1.2 integration.

Features

  • One saved consent choice, with /sslogs on and /sslogs off to change it.
  • Incremental collection of logs/latest.log and the latest recent crash report, limited to the current game directory.
  • Filtering of recognized chat lines, credentials, personal home-directory paths and IPv4 addresses before upload. Filtering is best effort; it cannot guarantee removal of every possible private detail.
  • Authenticated HTTPS delivery after the server verifies the player’s UUID and EzLogin login state.
  • English and Russian consent messages. Players can decline and continue using the server without automatic log collection.

Usage

Install the mod on the dedicated server and on clients that want automatic log collection. When the configured support service issues a valid request after login, the client asks for permission. The choice is saved per player UUID. Approved collection runs approximately once a minute while connected; /sslogs off stops future uploads.

Versions 1.0.0, 1.1.2 and 1.1.3 are the Steam & Steel service integration. Its upload destination is fixed to https://steamsteel.minecraft.best/client-logs. It is not a generic Discord webhook uploader, and installing the JAR alone does not create a Discord bot or storage service. Other server owners need to adapt the integration and provide their own authenticated backend before using it with their service.

On Steam & Steel, logs are retained for seven days and their contents are available to Admin and Founder for troubleshooting. A support report has an optional action to attach available logs. Declining collection does not prevent submitting a report.

The mod reads bounded portions rather than promising a complete log history: up to 256 KiB of the current log per collection and 128 KiB of the selected crash report. A crash report can be collected on the next successful connection; the mod cannot upload while Minecraft is closed. It does not request a Discord token or webhook from the player.

Compatibility

  • Minecraft 1.21.1
  • NeoForge 21.1.235, Java 21
  • Both client and server installation for the log-collection feature
  • The dedicated server needs the matching support-service backend and EzLogin authentication integration, tested with EzLogin 1.0.0

The backend and EzLogin are not bundled. If the server cannot verify authentication, it does not issue log requests. The optional network channel lets clients without this mod connect without the collection feature. This addon does not require Steam & Steel Companion or SteamSteelCore.

From Steam & Steel

Discord Logs originated in Steam & Steel SMP, our Minecraft 1.21.1 NeoForge server modpack. It is published as a separate integration module, independently of the Companion package. Its current service destination and retention policy are described above.

Acknowledgements

Original implementation by DanielBasov (Steam & Steel), using Minecraft and NeoForge APIs. EzLogin remains a separate mod by its original authors. Minecraft, NeoForge and Discord retain their own names and rights. This is an independent community addon and is not an official Discord product.

Beta / Feedback

This is a beta release prepared for the specific Steam & Steel server pack. The server integration has been installed and checked, and local collector, network-codec and dedicated-side loading checks passed. A real player’s complete update, consent, upload and Discord attachment flow has not yet been verified.

If you encounter a crash, an error or unexpected behaviour, leave a comment with the addon, Minecraft and NeoForge versions and steps to reproduce it. Include only relevant log excerpts with private details removed. We will investigate reported bugs and work on fixes.

License

Original code and project artwork are licensed under BSD 3-Clause. Copyright (c) 2026, DanielBasov (Steam & Steel). Forks, fixes and redistribution are permitted; retain the author attribution, license conditions and disclaimer. A fork may not imply endorsement by the original author.

The project icon is original voxel and pixel artwork made through our V3 pipeline. It contains no Discord logo or upstream game textures. The complete license accompanies the JAR and source archive.

常见问题

Discord Logs 支持哪些 Minecraft 版本?

Discord Logs 支持 Minecraft Java 版 1.21.1,可用的加载器:NeoForge。下载时注意选择和你游戏版本一致的文件。

Discord Logs 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。

评论

登录后评论和评分

DanielBasov 的其他作品

查看全部 →