Перейти к содержимому
Mineforgian

MineAds Monitor

🔌 Push your server analytics to MineAds

Загрузки
254
Подписчики
2
Обновлён
5 декабря 2025 г.
Лицензия
GPL-3.0-only

Опубликован 3 сентября 2025 г.

Исходный кодСообщить об ошибке

MineAds Monitor Plugin

We at MineAds provide this plugin to help Minecraft server owners integrate their servers with our analytics platform. It automatically tracks server activity like player joins, leaves, chat, and commands, then sends this data to us for analysis.

What We Use It For

As a server analytics platform, we collect data from servers that sign up their networks with us. We use this information to provide detailed analytics to server owners, helping them understand player behavior, optimize their servers, and improve their community's experience. This data also helps us enhance our platform's insights.

Setup Instructions

  1. Download the plugin JAR file that matches your server type (Bukkit/Spigot/Paper, BungeeCord, or Velocity).
  2. Place the JAR in your server's plugins folder.
  3. Restart your server to generate the config file.
  4. Open the config.yml file in your plugins/MineAdsMonitor folder.
  5. Add your unique plugin key from the MineAds dashboard (it starts with "pluginkey_").
  6. Set a server ID like "survival-main" to identify this server.
  7. Save the file and restart the server again.

Configuration Options

The plugin uses a simple YAML format for its settings. Here's what each option does:

  • pluginKey: Your special key from MineAds that links your server to their system. You get this from their website.
  • serverId: A name for your server, like "creative-hub" or "pvp-arena", using only letters, numbers, and dashes.
  • enabledEvents: Choose which types of player activities to track. By default, it tracks everything: purchases, chat, commands, joins, and leaves.
  • disableChatContent: Turn this on if you don't want the actual words players type in chat to be sent (only that they chatted).
  • defaultMaxCommandArgs: How many parts of a command to record. For example, "/warp home" would save 1 part (just "warp") by default.
  • commandArgLimits: Set different limits for specific commands, like allowing more details for "/warp" commands.
  • debug: Turn this on to see extra messages in the server console for troubleshooting.

Commands

The plugin includes commands for server admins (you need the "mineadsmonitor.admin" permission):

  • /mineadsmonitor help: Shows all available commands.
  • /mineadsmonitor version: Tells you what version of the plugin you're running.
  • /mineadsmonitor reload: Reloads the config file without restarting the server.
  • /mineadsmonitor initial/expiry/renewal/chargeback/refund [details]: Manually record purchase-related events (like when someone buys or loses a rank).

Performance and Lag Prevention

To keep your server running smoothly, the plugin is designed to be very lightweight:

  • It collects data in the background without slowing down gameplay.
  • Instead of sending data immediately, it groups events together and sends them in batches every 10 seconds.
  • All network requests happen on separate threads, so they never interrupt your server's main operations.
  • Data is compressed before sending to use less bandwidth.
  • If there are connection problems, it automatically retries with smart delays to avoid overwhelming your server.

Ченджлог

1.0.3-velocityРелиз1.21.8, 1.21.9, 1.21.10 · 5 декабря 2025 г.

🚀 Features

  • 399c622 feat: implement heartbeats

🐛 Fixes

  • ddb0ede fix(deps): update dependency com.gradleup.shadow:shadow-gradle-plugin to v9.2.2 (#26)
  • f57a3f2 fix(deps): update dependency net.md-5:bungeecord-api to v1.21-r0.4 (#29)
  • 033976c fix(deps): update dependency com.diffplug.spotless:spotless-plugin-gradle to v8 (#25)
  • 3c3006c fix(deps): update dependency io.freefair.gradle:lombok-plugin to v9 (#28)
  • 346d258 fix(deps): update all non-major dependencies to v4.25.0 (#34)
  • f54400c fix(deps): update all non-major dependencies to v2.0.0-beta.12 (#35)
  • 65af380 fix(deps): update all non-major dependencies to v2.0.0-beta.13 (#37)
  • 0870ee1 fix(deps): update all non-major dependencies (#39)
  • 91233b5 fix(deps): update dependency de.exlll:configlib-yaml to v4.6.2 (#41)
  • cdf88ca fix(deps): update dependency com.google.protobuf:protobuf-java to v4.33.0 (#42)
  • 511f635 fix(deps): update dependency de.exlll:configlib-yaml to v4.6.3 (#43)
  • 78b0e4b fix(deps): update all non-major dependencies (#44)
  • b3c368c fix(deps): update dependency net.kyori:indra-git to v4 (#40)
  • 54297cf fix(deps): update dependency io.freefair.gradle:lombok-plugin to v9.1.0
  • 346b9b2 fix(deps): update all non-major dependencies
  • 51d06c3 fix(deps): update dependency com.google.protobuf:protobuf-java to v4.33.1
  • ae4838a fix(deps): update dependency de.exlll:configlib-yaml to v4.6.4
  • 8a82bed fix(deps): update dependency com.diffplug.spotless:spotless-plugin-gradle to v8.1.0
  • 0ee815c fix(deps): update dependency com.github.spotbugs.snom:spotbugs-gradle-plugin to v6.4.6
  • bc398ee fix: redo event tracking config
  • 18b3838 fix: disable linting generated classes
  • 75261c5 fix(deps): update dependency com.github.spotbugs.snom:spotbugs-gradle-plugin to v6.4.7
  • 9f6dfeb fix: add header

🔨 Build

  • 3313508 chore(release): bump version to 1.0.3-SNAPSHOT
  • 50cf69f ci: improve discord message
  • 211e04c ci: show MineAds logo for monitor message
  • b58eb15 ci: show correct download link in gh changelog
  • f87e30b chore(deps): update dependency org.junit.jupiter:junit-jupiter to v5.14.0 (#30)
  • 399878f chore(deps): update dependency io.freefair.gradle:lombok-plugin to v9 (#27)
  • f282438 chore(deps): update dependency com.diffplug.spotless:spotless-plugin-gradle to v8 (#24)
  • 6de9823 chore(deps): update gradle/actions action to v5 (#32)
  • 669309f chore(deps): update dependency org.junit.jupiter:junit-jupiter to v6 (#31)
  • e98bd39 chore(deps): update all non-major dependencies to v3.0.1 (#33)
  • 6ef405f chore(deps): update all non-major dependencies to v3.0.2 (#36)
  • 31fc854 chore(deps): update stefanzweifel/git-auto-commit-action action to v7 (#38)
  • 21a6892 chore(deps): update dependency com.google.errorprone:error_prone_core to v2.43.0 (#45)
  • ac900fa chore(deps): update actions/upload-artifact action to v5 (#46)
  • f662958 chore(deps): update gradle to v9.2.0
  • ada46f1 chore(deps): update mikepenz/release-changelog-builder-action action to v6 (#47)
  • 2b1d103 chore(deps): update dependency org.junit.jupiter:junit-jupiter to v6.0.1
  • 2dd4fbf chore: make spotbugs more sensitive
  • 5113689 chore(deps): update dependency com.google.errorprone:error_prone_core to v2.44.0
  • 3aeed7e chore(deps): update gradle to v9.2.1
  • 1a77d9e chore(deps): update actions/checkout action to v6 (#48)
  • 51ac23a chore(deps): update dependency com.google.errorprone:error_prone_core to v2.45.0
  • 672510f chore(release): bump version to 1.0.3

💬 Other

  • 8ea5f71 Add automergeType to renovate.json configuration
1.0.3-bungeeРелиз1.21.8, 1.21.9, 1.21.10 · 5 декабря 2025 г.

🚀 Features

  • 399c622 feat: implement heartbeats

🐛 Fixes

  • ddb0ede fix(deps): update dependency com.gradleup.shadow:shadow-gradle-plugin to v9.2.2 (#26)
  • f57a3f2 fix(deps): update dependency net.md-5:bungeecord-api to v1.21-r0.4 (#29)
  • 033976c fix(deps): update dependency com.diffplug.spotless:spotless-plugin-gradle to v8 (#25)
  • 3c3006c fix(deps): update dependency io.freefair.gradle:lombok-plugin to v9 (#28)
  • 346d258 fix(deps): update all non-major dependencies to v4.25.0 (#34)
  • f54400c fix(deps): update all non-major dependencies to v2.0.0-beta.12 (#35)
  • 65af380 fix(deps): update all non-major dependencies to v2.0.0-beta.13 (#37)
  • 0870ee1 fix(deps): update all non-major dependencies (#39)
  • 91233b5 fix(deps): update dependency de.exlll:configlib-yaml to v4.6.2 (#41)
  • cdf88ca fix(deps): update dependency com.google.protobuf:protobuf-java to v4.33.0 (#42)
  • 511f635 fix(deps): update dependency de.exlll:configlib-yaml to v4.6.3 (#43)
  • 78b0e4b fix(deps): update all non-major dependencies (#44)
  • b3c368c fix(deps): update dependency net.kyori:indra-git to v4 (#40)
  • 54297cf fix(deps): update dependency io.freefair.gradle:lombok-plugin to v9.1.0
  • 346b9b2 fix(deps): update all non-major dependencies
  • 51d06c3 fix(deps): update dependency com.google.protobuf:protobuf-java to v4.33.1
  • ae4838a fix(deps): update dependency de.exlll:configlib-yaml to v4.6.4
  • 8a82bed fix(deps): update dependency com.diffplug.spotless:spotless-plugin-gradle to v8.1.0
  • 0ee815c fix(deps): update dependency com.github.spotbugs.snom:spotbugs-gradle-plugin to v6.4.6
  • bc398ee fix: redo event tracking config
  • 18b3838 fix: disable linting generated classes
  • 75261c5 fix(deps): update dependency com.github.spotbugs.snom:spotbugs-gradle-plugin to v6.4.7
  • 9f6dfeb fix: add header

🔨 Build

  • 3313508 chore(release): bump version to 1.0.3-SNAPSHOT
  • 50cf69f ci: improve discord message
  • 211e04c ci: show MineAds logo for monitor message
  • b58eb15 ci: show correct download link in gh changelog
  • f87e30b chore(deps): update dependency org.junit.jupiter:junit-jupiter to v5.14.0 (#30)
  • 399878f chore(deps): update dependency io.freefair.gradle:lombok-plugin to v9 (#27)
  • f282438 chore(deps): update dependency com.diffplug.spotless:spotless-plugin-gradle to v8 (#24)
  • 6de9823 chore(deps): update gradle/actions action to v5 (#32)
  • 669309f chore(deps): update dependency org.junit.jupiter:junit-jupiter to v6 (#31)
  • e98bd39 chore(deps): update all non-major dependencies to v3.0.1 (#33)
  • 6ef405f chore(deps): update all non-major dependencies to v3.0.2 (#36)
  • 31fc854 chore(deps): update stefanzweifel/git-auto-commit-action action to v7 (#38)
  • 21a6892 chore(deps): update dependency com.google.errorprone:error_prone_core to v2.43.0 (#45)
  • ac900fa chore(deps): update actions/upload-artifact action to v5 (#46)
  • f662958 chore(deps): update gradle to v9.2.0
  • ada46f1 chore(deps): update mikepenz/release-changelog-builder-action action to v6 (#47)
  • 2b1d103 chore(deps): update dependency org.junit.jupiter:junit-jupiter to v6.0.1
  • 2dd4fbf chore: make spotbugs more sensitive
  • 5113689 chore(deps): update dependency com.google.errorprone:error_prone_core to v2.44.0
  • 3aeed7e chore(deps): update gradle to v9.2.1
  • 1a77d9e chore(deps): update actions/checkout action to v6 (#48)
  • 51ac23a chore(deps): update dependency com.google.errorprone:error_prone_core to v2.45.0
  • 672510f chore(release): bump version to 1.0.3

💬 Other

  • 8ea5f71 Add automergeType to renovate.json configuration
1.0.3-bukkitРелиз1.21.8, 1.21.9, 1.21.10 · 5 декабря 2025 г.

🚀 Features

  • 399c622 feat: implement heartbeats

🐛 Fixes

  • ddb0ede fix(deps): update dependency com.gradleup.shadow:shadow-gradle-plugin to v9.2.2 (#26)
  • f57a3f2 fix(deps): update dependency net.md-5:bungeecord-api to v1.21-r0.4 (#29)
  • 033976c fix(deps): update dependency com.diffplug.spotless:spotless-plugin-gradle to v8 (#25)
  • 3c3006c fix(deps): update dependency io.freefair.gradle:lombok-plugin to v9 (#28)
  • 346d258 fix(deps): update all non-major dependencies to v4.25.0 (#34)
  • f54400c fix(deps): update all non-major dependencies to v2.0.0-beta.12 (#35)
  • 65af380 fix(deps): update all non-major dependencies to v2.0.0-beta.13 (#37)
  • 0870ee1 fix(deps): update all non-major dependencies (#39)
  • 91233b5 fix(deps): update dependency de.exlll:configlib-yaml to v4.6.2 (#41)
  • cdf88ca fix(deps): update dependency com.google.protobuf:protobuf-java to v4.33.0 (#42)
  • 511f635 fix(deps): update dependency de.exlll:configlib-yaml to v4.6.3 (#43)
  • 78b0e4b fix(deps): update all non-major dependencies (#44)
  • b3c368c fix(deps): update dependency net.kyori:indra-git to v4 (#40)
  • 54297cf fix(deps): update dependency io.freefair.gradle:lombok-plugin to v9.1.0
  • 346b9b2 fix(deps): update all non-major dependencies
  • 51d06c3 fix(deps): update dependency com.google.protobuf:protobuf-java to v4.33.1
  • ae4838a fix(deps): update dependency de.exlll:configlib-yaml to v4.6.4
  • 8a82bed fix(deps): update dependency com.diffplug.spotless:spotless-plugin-gradle to v8.1.0
  • 0ee815c fix(deps): update dependency com.github.spotbugs.snom:spotbugs-gradle-plugin to v6.4.6
  • bc398ee fix: redo event tracking config
  • 18b3838 fix: disable linting generated classes
  • 75261c5 fix(deps): update dependency com.github.spotbugs.snom:spotbugs-gradle-plugin to v6.4.7
  • 9f6dfeb fix: add header

🔨 Build

  • 3313508 chore(release): bump version to 1.0.3-SNAPSHOT
  • 50cf69f ci: improve discord message
  • 211e04c ci: show MineAds logo for monitor message
  • b58eb15 ci: show correct download link in gh changelog
  • f87e30b chore(deps): update dependency org.junit.jupiter:junit-jupiter to v5.14.0 (#30)
  • 399878f chore(deps): update dependency io.freefair.gradle:lombok-plugin to v9 (#27)
  • f282438 chore(deps): update dependency com.diffplug.spotless:spotless-plugin-gradle to v8 (#24)
  • 6de9823 chore(deps): update gradle/actions action to v5 (#32)
  • 669309f chore(deps): update dependency org.junit.jupiter:junit-jupiter to v6 (#31)
  • e98bd39 chore(deps): update all non-major dependencies to v3.0.1 (#33)
  • 6ef405f chore(deps): update all non-major dependencies to v3.0.2 (#36)
  • 31fc854 chore(deps): update stefanzweifel/git-auto-commit-action action to v7 (#38)
  • 21a6892 chore(deps): update dependency com.google.errorprone:error_prone_core to v2.43.0 (#45)
  • ac900fa chore(deps): update actions/upload-artifact action to v5 (#46)
  • f662958 chore(deps): update gradle to v9.2.0
  • ada46f1 chore(deps): update mikepenz/release-changelog-builder-action action to v6 (#47)
  • 2b1d103 chore(deps): update dependency org.junit.jupiter:junit-jupiter to v6.0.1
  • 2dd4fbf chore: make spotbugs more sensitive
  • 5113689 chore(deps): update dependency com.google.errorprone:error_prone_core to v2.44.0
  • 3aeed7e chore(deps): update gradle to v9.2.1
  • 1a77d9e chore(deps): update actions/checkout action to v6 (#48)
  • 51ac23a chore(deps): update dependency com.google.errorprone:error_prone_core to v2.45.0
  • 672510f chore(release): bump version to 1.0.3

💬 Other

  • 8ea5f71 Add automergeType to renovate.json configuration
1.0.2-velocityРелиз1.21.6, 1.21.7, 1.21.8 · 24 сентября 2025 г.

🐛 Fixes

  • e10aa4b fix: add platform dependency info

🔨 Build

  • d131f1c chore(release): bump version to 1.0.2
1.0.2-bungeeРелиз1.21.6, 1.21.7, 1.21.8 · 24 сентября 2025 г.

🐛 Fixes

  • e10aa4b fix: add platform dependency info

🔨 Build

  • d131f1c chore(release): bump version to 1.0.2
1.0.2-bukkitРелиз1.21.6, 1.21.7, 1.21.8 · 24 сентября 2025 г.

🐛 Fixes

  • e10aa4b fix: add platform dependency info

🔨 Build

  • d131f1c chore(release): bump version to 1.0.2
1.0.1-velocityРелиз1.21.6, 1.21.7, 1.21.8 · 24 сентября 2025 г.

no changes

1.0.1-bungeeРелиз1.21.6, 1.21.7, 1.21.8 · 24 сентября 2025 г.

no changes

Комментарии

Загружаем…