{"id":29123047,"url":"https://github.com/aternosorg/mclogs-integration","last_synced_at":"2025-06-29T18:05:31.180Z","repository":{"id":279428543,"uuid":"938776878","full_name":"aternosorg/mclogs-integration","owner":"aternosorg","description":"A mod/plugin to easily share and analyse your server logs with mclo.gs","archived":false,"fork":false,"pushed_at":"2025-06-18T12:24:22.000Z","size":361,"stargazers_count":4,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-22T01:44:12.137Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://mclo.gs","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aternosorg.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-25T13:40:28.000Z","updated_at":"2025-06-18T12:24:25.000Z","dependencies_parsed_at":"2025-02-25T14:43:23.471Z","dependency_job_id":"5ac4b3ca-4ae5-4acb-9d52-c9c23a35287f","html_url":"https://github.com/aternosorg/mclogs-integration","commit_stats":null,"previous_names":["aternosorg/mclogs-integration"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/aternosorg/mclogs-integration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aternosorg%2Fmclogs-integration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aternosorg%2Fmclogs-integration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aternosorg%2Fmclogs-integration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aternosorg%2Fmclogs-integration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aternosorg","download_url":"https://codeload.github.com/aternosorg/mclogs-integration/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aternosorg%2Fmclogs-integration/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262642953,"owners_count":23341817,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-29T18:05:29.532Z","updated_at":"2025-06-29T18:05:31.164Z","avatar_url":"https://github.com/aternosorg.png","language":"Java","funding_links":[],"categories":["Plugins"],"sub_categories":["Utility"],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://mclo.gs\"\u003e\n        \u003cimg src=\"https://mclo.gs/img/logo.png\" alt=\"Logo\" width=\"350\" height=\"120\"\u003e\n    \u003c/a\u003e\n    \u003ch3\u003eServer Plugin/Mod\u003c/h3\u003e\n    \u003cp\u003e\n        Upload your logs to \u003ca href=\"https://mclo.gs\" target=\"_blank\"\u003emclo.gs\u003c/a\u003e with a single command to analyze or share them.\n        \u003cbr /\u003e\n        Critical information like IP addresses are automatically hidden to ensure safety and privacy.\n        \u003cbr /\u003e\n        It's also possible to export old server log files, e.g. after a crash.\n        \u003cbr /\u003e\n        \u003ca href=\"https://modrinth.com/plugin/mclogs\" target=\"_blank\"\u003e\u003cstrong\u003e« Download Plugin/Mod on Modrinth »\u003c/strong\u003e\u003c/a\u003e\n        \u003cbr /\u003e\n        \u003cbr /\u003e\n        \u003ca href=\"https://www.spigotmc.org/resources/mclo-gs.47502/\" target=\"_blank\"\u003eSpigotMC\u003c/a\u003e\n        ·\n        \u003ca href=\"https://www.curseforge.com/minecraft/bukkit-plugins/mclo-gs\" target=\"_blank\"\u003eCurseForge (Plugin)\u003c/a\u003e\n        ·\n        \u003ca href=\"https://www.curseforge.com/minecraft/mc-mods/mclo-gs\" target=\"_blank\"\u003eCurseForge (Mod)\u003c/a\u003e\n        ·\n        \u003ca href=\"https://hangar.papermc.io/Aternos/mclogs\" target=\"_blank\"\u003eHangar\u003c/a\u003e\n    \u003c/p\u003e\n\u003c/div\u003e\n\n\n## About mclo.gs\n\n\u003ca href=\"https://mclo.gs\" target=\"_blank\"\u003emclo.gs\u003c/a\u003e allows you to quickly share and analyze logs for Minecraft servers and clients. It highlights different log levels, removes sensitive information like IP-Addresses and detects common problems as well as version information.\n\n## Commands\n\nThe Plugin/Mod contains the following commands:\n\n| Command      | Arguments     | Description                                                   | Permission Level | Permission Node |\n|--------------|---------------|---------------------------------------------------------------|------------------|-----------------|\n| mclogs       |               | Share the current server log                                  | 2                | mclogs          |\n| mclogs list  |               | List server logs, crash- and network protocol error reports   | 2                | mclogs.list     |\n| mclogs share | \\\u003cfile-name\\\u003e | Share a specific log, crash- or network protocol error report | 2                | mclogs.share    |\n\nFor special cases, the following commands are available:\n\n| Scenario                               | Command                   | Behavior           |\n|----------------------------------------|---------------------------|--------------------|\n| Mod installed client-side              | `/mclogsc`                | Handle client logs |\n| Plugin installed on a Velocity proxy   | `/mclogsp` and `/mclogsv` | Handle proxy logs  |\n| Plugin installed on a BungeeCord proxy | `/mclogsp` and `/mclogsb` | Handle proxy logs  |\n\n### Permissions\n\nCommands are not available to players by default. You can give players access to the commands by giving them the \nrequired permissions. Plugin servers permissions use permission nodes for fine-grained access control. The `mclogs`\npermission node is required for all other commands as well.\n\nModded servers use the Vanilla permission level system instead.\n\n## Configuration\nIf you use a self-hosted instance of mclo.gs or want to use an alternative front-end, you can configure the plugin/mod to use your instance.\nThe config file is located in `plugins/mclogs/config.toml` for plugin servers and `config/mclogs.toml` for modded servers.\n\n### Default configuration\n```toml\n# Base URL for the API used to upload logs\napiBaseUrl = \"https://api.mclo.gs\"\n# URL to view logs on the web\n# A trailing slash and the log ID will be appended to this URL\nviewLogsUrl = \"https://mclo.gs\"\n```\n\n## Requirements\nThis project requires Java 11 or higher to run, even on Minecraft versions that run on Java 8.\n\n## Contributing\nThis project is licensed as MIT. Contributions are welcome but if you plan some larger changes please\ncreate an issue for discussion first, to avoid wasting time on something that might not be merged.\n\n### Setting up the Development Environment\n1. Clone the repository\n2. Import the project in your IDE (IntelliJ IDEA is recommended)\n3. Run `./gradlew :forge:genIntellijRuns :neoforge:createLaunchScripts` to generate the Forge/NeoForge runs\n\n### Modules\n\n| Module     | Description                                                                    | Parent Module |\n|------------|--------------------------------------------------------------------------------|---------------|\n| common     | Code shared between all platforms                                              |               |\n| common-mc  | Code shared between all platforms that provide access to the Minecraft classes | common        |\n| adventure  | Code shared between all platforms that use the adventure component library     | common        |\n| bukkit     | Bukkit plugin implementation                                                   | adventure     |\n| bungeecord | BungeeCord plugin implementation                                               | adventure     |\n| velocity   | Velocity plugin implementation                                                 | adventure     |\n| forge      | Forge mod implementation                                                       | common-mc     |\n| fabric     | Fabric mod implementation                                                      | common-mc     |\n| neoforge   | NeoForge mod implementation                                                    | common-mc     |\n\n### Building\nTo build all modules run `./gradlew buildAll`. Unless specified below all other modules use the `build` task.\n\nModules with special build task:\n\n| Module     | Task        |\n|------------|-------------|\n| bukkit     | `shadowJar` |\n| bungeecord | `shadowJar` |\n| velocity   | `shadowJar` |\n| forge      | `jarJar`    |\n\n### Running in development environments\nIf you're using IntelliJ IDEA you should already see run configurations for most platforms.\nFor other platforms or other IDEs run their respective gradle tasks:\n\n| Platform   | Client Task                     | Server Task                           |\n|------------|---------------------------------|---------------------------------------|\n| Bukkit     |                                 | `./gradlew :bukkit:runServer`         |\n| BungeeCord |                                 | `./gradlew :bungeecord:runBungeeCord` |\n| Velocity   |                                 | `./gradlew :velocity:runVelocity`     |\n| Forge      | `./gradlew :forge:Client`       | `./gradlew :forge:Server`             |\n| Fabric     | `./gradlew :fabric:runClient`   | `./gradlew :fabric:runServer`         |\n| NeoForge   | `./gradlew :neoforge:runClient` | `./gradlew :neoforge:runServer`       |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faternosorg%2Fmclogs-integration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faternosorg%2Fmclogs-integration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faternosorg%2Fmclogs-integration/lists"}