{"id":28988590,"url":"https://github.com/thevihara/json-microservices-platform","last_synced_at":"2026-05-05T09:32:00.638Z","repository":{"id":299033122,"uuid":"997992740","full_name":"TheVihara/json-microservices-platform","owner":"TheVihara","description":"Modular microservices platform (Java/Kotlin) for Minecraft servers. NATS, Protocol Buffers, scalable backend.","archived":false,"fork":false,"pushed_at":"2025-06-22T18:11:55.000Z","size":6734,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-22T19:24:46.588Z","etag":null,"topics":["backend","bukkit","cloud-native","distributed-systems","event-driven","extensible","game-server","gradle","java","junit","kotlin","microservices","minecraft","modular-architecture","nats","protobuf","protocol-buffers","scalable","service-platform","velocity"],"latest_commit_sha":null,"homepage":"","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/TheVihara.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"zenodo":null}},"created_at":"2025-06-07T16:30:52.000Z","updated_at":"2025-06-22T18:11:58.000Z","dependencies_parsed_at":"2025-06-14T09:20:38.120Z","dependency_job_id":"1ffd8a6a-b6a1-400b-b9be-c0385c3c9d18","html_url":"https://github.com/TheVihara/json-microservices-platform","commit_stats":null,"previous_names":["thevihara/unnamed-platform","thevihara/json-microservices-platform"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TheVihara/json-microservices-platform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheVihara%2Fjson-microservices-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheVihara%2Fjson-microservices-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheVihara%2Fjson-microservices-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheVihara%2Fjson-microservices-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheVihara","download_url":"https://codeload.github.com/TheVihara/json-microservices-platform/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheVihara%2Fjson-microservices-platform/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261764297,"owners_count":23206248,"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":["backend","bukkit","cloud-native","distributed-systems","event-driven","extensible","game-server","gradle","java","junit","kotlin","microservices","minecraft","modular-architecture","nats","protobuf","protocol-buffers","scalable","service-platform","velocity"],"created_at":"2025-06-24T22:02:20.620Z","updated_at":"2026-05-05T09:32:00.604Z","avatar_url":"https://github.com/TheVihara.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# nats-microservices-platform\n\n## Overview\n\n**nats-microservices-platform** is a modular, scalable microservices platform built with **Java** and **Kotlin** for distributed systems and Minecraft server integration. Designed to accelerate backend development, it features **NATS messaging**, **Protocol Buffers (protobuf)** serialization, and a robust, extensible architecture. The platform supports both cloud-native deployments and game server environments (Bukkit, Velocity).\n\n## Key Features\n\n- **Modular Microservices Architecture:** Build, deploy, and scale independent Java/Kotlin services easily.\n- **NATS Messaging Integration:** High-performance, event-driven communication between services using [NATS](https://nats.io/).\n- **Protocol Buffers:** Efficient, type-safe data serialization using [Google Protocol Buffers](https://developers.google.com/protocol-buffers).\n- **Minecraft Server Support:** Out-of-the-box integration with **Bukkit** and **Velocity** for Minecraft plugin and proxy development.\n- **Extensible and Configurable:** Easily add new services and customize configurations per module.\n- **Cloud-Native Ready:** Supports scalable deployments, configuration management, and robust service orchestration.\n- **Automated Testing:** Built-in support for **JUnit 5** for comprehensive unit and integration testing.\n\n## Technologies Used\n\n- **Java 17+** \u0026 **Kotlin**\n- **NATS (jnats)**\n- **Protocol Buffers (protobuf-java, protoc)**\n- **Gradle (Kotlin DSL)**\n- **JUnit 5**\n- **LuckPerms** (for permissions)\n- **jshepherd** (configuration)\n- **Bukkit** and **Velocity** (Minecraft APIs)\n\n## Main Modules\n\n- **common**: Shared utilities, service abstractions, and configuration.\n- **service:auth**: Authentication and security service.\n- **service:party**: Party/group management.\n- **service:friend**: Social/friends features.\n- **service:permission**: Permissions management (LuckPerms integration).\n- **service:punishment**: Moderation and punishment service.\n- **service:deploy**: Deployment/orchestration tools.\n- **service:player**: Player profile and management.\n- **service:command**: Command processing and registration.\n- **minecraft:bukkit**: Bukkit Minecraft server integration.\n- **minecraft:velocity**: Velocity Minecraft proxy integration.\n\n## Getting Started\n\n1. **Clone the Repository**\n   ```sh\n   git clone https://github.com/TheVihara/nats-microservices-platform.git\n   cd nats-microservices-platform\n   ```\n\n2. **Build the Project**\n   ```sh\n   ./gradlew build\n   ```\n\n3. **Configure Services**\n   - Each service uses a `service.yml` configuration file.\n   - See `service/common/src/main/java/net/unnamed/service/common/config/ServiceConfig.java` for required options.\n\n4. **Run a Service**\n   - Use the provided main classes in each module to start individual services.\n\n## Why nats-microservices-platform?\n\n- **Optimized for Java/Kotlin Microservices:** Built for modern JVM development with seamless NATS and protobuf integration.\n- **Production-Ready Distributed Systems:** Designed for scalability, reliability, and extensibility.\n- **Minecraft Server Friendly:** Plug-and-play modules for Bukkit and Velocity Minecraft environments.\n- **Cloud-Native Architecture:** Supports containerization, orchestration, and scalable deployments.\n- **Active Development:** Modular design makes contribution and extension easy.\n\n## Contributing\n\nWe welcome contributions! Fork the repo and open a pull request.\n\n## License\n\nMIT License\n\n---\n\n*Built and maintained by [TheVihara](https://github.com/TheVihara).*\n\n---\n\n**SEO Keywords:**  \njava, kotlin, microservices, distributed-systems, nats, protocol-buffers, protobuf, modular-architecture, backend, service-platform, minecraft, bukkit, velocity, game-server, cloud-native, event-driven, gradle, junit, extensible, scalable\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthevihara%2Fjson-microservices-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthevihara%2Fjson-microservices-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthevihara%2Fjson-microservices-platform/lists"}