{"id":19055810,"url":"https://github.com/dragonstudio-store/ds-ads-ultimate","last_synced_at":"2025-09-10T15:38:47.320Z","repository":{"id":243611866,"uuid":"812900819","full_name":"DragonStudio-Store/DS-Ads-Ultimate","owner":"DragonStudio-Store","description":"DS-Ads Ultimate source code","archived":false,"fork":false,"pushed_at":"2024-10-31T15:27:18.000Z","size":2438,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-22T01:27:46.297Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DragonStudio-Store.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2024-06-10T05:54:44.000Z","updated_at":"2024-10-31T15:27:21.000Z","dependencies_parsed_at":null,"dependency_job_id":"bb5086f4-5b6d-46a6-b906-d690ed7872c1","html_url":"https://github.com/DragonStudio-Store/DS-Ads-Ultimate","commit_stats":null,"previous_names":["dragonstudio-store/ds-ads-ultimate"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DragonStudio-Store/DS-Ads-Ultimate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DragonStudio-Store%2FDS-Ads-Ultimate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DragonStudio-Store%2FDS-Ads-Ultimate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DragonStudio-Store%2FDS-Ads-Ultimate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DragonStudio-Store%2FDS-Ads-Ultimate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DragonStudio-Store","download_url":"https://codeload.github.com/DragonStudio-Store/DS-Ads-Ultimate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DragonStudio-Store%2FDS-Ads-Ultimate/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262329629,"owners_count":23294729,"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":"2024-11-08T23:47:05.552Z","updated_at":"2025-06-27T20:36:43.775Z","avatar_url":"https://github.com/DragonStudio-Store.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DS-Ads Ultimate\r\n\r\nDS-Ads is a Minecraft plugin designed to enhance your server's advertisement capabilities. With DS-Ads, you can send customized ads to players via chat, boss bars, action bars, and titles. This plugin is fully configurable and supports permissions for managing who can send and manage ads.\r\n\r\n## Features\r\n\r\n- Customizable welcome messages for new players.\r\n- Configurable ad formats including chat, boss bar, action bar, and title.\r\n- Permissions to control ad management and sending.\r\n- Easy configuration and reloading of settings.\r\n\r\n## Installation\r\n\r\n1. Download the latest version of the DS-Ads plugin.\r\n2. Place the plugin jar file in your server's `plugins` directory.\r\n3. Restart your server to generate the default configuration files.\r\n4. Edit the `Settings.yml` file to customize the plugin settings to your needs.\r\n5. Use the `/ads reload` command to apply the changes without restarting the server.\r\n\r\n## Configuration\r\n\r\nThe configuration file (`Settings.yml`) includes settings for plugin behavior, permissions, and customizable messages. Below is an example of the configuration options:\r\n\r\n```yaml\r\n# Plugin Settings, you can edit them according to your needs.\r\nPlugin-Configuration:\r\n  Enabled: true\r\n  Disable-MCJoinLeave-Messages: true\r\n\r\n# Plugin permissions\r\nPlugin-Permissions:\r\n  Send-Ads: ads.send\r\n  Manage-Ads: ads.manage\r\n  Reload-Plugin: ads.reload\r\n\r\n# Plugin messages, you can edit them according to your needs.\r\nMessages:\r\n  Prefix: \"\u003cyellow\u003eDS-\u003cred\u003eADS \u003cdark_gray\u003e\u003cbold\u003e» \u003creset\u003e\"\r\n  No-Perms: \"\u003cred\u003eYou dont have permissions to run this command\"\r\n  No-Subcmd: \"\u003cred\u003eThis command doesnt exist\"\r\n  No-Ad-Found: \"\u003cred\u003eThis ad doesnt exist\"\r\n  No-Player-Found: \"\u003cred\u003eThis player doesnt exist\"\r\n  Ad-Failed: \"\u003cred\u003eError sending ad to player\"\r\n  Reloaded-Sucess: \"\u003cgreen\u003eConfig was reloaded correctly\"\r\n  Only-players: \"\u003cred\u003eThis command can only be used by players\"\r\n  Disabled-Plugin: \"\u003cred\u003eThe plugin was successfully disabled\"\r\n  Already-Disabled-Plugin: \"\u003cred\u003eThe plugin is already disabled\"\r\n  Enabled-Plugin: \"\u003cgreen\u003eThe plugin was successfully enabled\"\r\n  Already-Enabled-Plugin: \"\u003cred\u003eThe plugin is already enabled\"\r\n  Everyone-Send: \"\u003cgreen\u003eAd sent to all players\"\r\n  Player-Send: \"\u003cgreen\u003eAd sent correctly to the player\"\r\n  Usage: \"\u003cyellow\u003eUsage: /ads send \u003cAdName\u003e \u003cPlayer/*\u003e\"\r\n\r\n# Advertisement configuration\r\nAds-Configuration:\r\n  Ads-Cooldown: 15 # In Seconds, For all ads\r\n  Ad-Example-1:\r\n    worlds:\r\n      - world\r\n    permission: ads.ad1\r\n    Chat:\r\n      Enabled: true\r\n      Sound: BLOCK_NOTE_BLOCK_PLING\r\n      Ad-content:\r\n        - ''\r\n        - '\u003cdark_gray\u003e\u003cst\u003e-----------------------------------------------------'\r\n        - ''\r\n        - '\u003ccenter\u003e\u003caqua\u003e\u003cbold\u003eHi %player_name%\u003c/bold\u003e\u003c/aqua\u003e\u003c/center\u003e'\r\n        - ''\r\n        - '\u003ccenter\u003e\u003cgray\u003eWhat do you think of this plugin?\u003c/gray\u003e\u003c/center\u003e'\r\n        - ''\r\n        - '\u003cdark_gray\u003e\u003cst\u003e-----------------------------------------------------'\r\n    Bossbar:\r\n      Enabled: true\r\n      Message: \"\u003cgradient:#ff5555:#5555ff\u003eLook, a Bossbar with MiniMessage\u003c/gradient\u003e\"\r\n      Color: PINK\r\n      Style: SOLID\r\n    Actionbar:\r\n      Enabled: true\r\n      Message: \"\u003cgradient:#55ff55:#5555ff\u003eAnd here you have one in ActionBar\u003c/gradient\u003e\"\r\n    Title:\r\n      Enabled: true\r\n      Title: \"\u003cblue\u003eDS-Ads\u003c/blue\u003e\"\r\n      Subtitle: \"\u003cyellow\u003eThanks for another opportunity!\u003c/yellow\u003e\"\r\n      FadeIn: 10\r\n      Stay: 70\r\n      FadeOut: 20\r\n```\r\n\r\n## Permissions\r\n\r\n- `ads.send` - Allows the user to send ads.\r\n- `ads.manage` - Allows the user to manage ads.\r\n- `ads.reload` - Allows the user to reload the plugin configuration.\r\n\r\n## Commands\r\n\r\n- `/ads send \u003cAdName\u003e \u003cPlayer/*\u003e` - Sends the specified ad to a player or all players.\r\n- `/ads reload` - Reloads the plugin configuration.\r\n- `/ads enable` - Enables the plugin.\r\n- `/ads disable` - Disables the plugin.\r\n\r\n## Contribution\r\n\r\nWe welcome contributions from the community! If you have ideas for new features, find a bug, or want to improve the code, feel free to open an issue or submit a pull request. Please ensure your contributions adhere to our coding standards and include appropriate tests where applicable.\r\n\r\n## Community Help\r\n\r\nIf you need help with the plugin, you can:\r\n\r\n1. Check the [Wiki](https://wiki.dragonstudio.site) for detailed documentation.\r\n2. Join our [Discord server](https://discord.dragonstudio.site) to ask questions and get support from the community.\r\n3. Open an issue on GitHub if you find any bugs or have feature requests.\r\n\r\n## Code of Conduct\r\n\r\nWe expect all contributors to adhere to our [Code of Conduct](CODE_OF_CONDUCT.md). Please read it to understand the expected behavior in our community.\r\n\r\n## License\r\n\r\nDS-Ads is licensed under the GNU General Public License v3.0. See the [LICENSE](LICENSE) file for more details.\r\n\r\n## No Plagiarism\r\n\r\nWe take plagiarism seriously. Ensure that your contributions are original and appropriately attributed if they build upon the work of others. Plagiarized contributions will not be accepted and may lead to being banned from the project.\r\n\r\n---\r\n\r\nThank you for using DS-Ads! We hope it enhances your Minecraft server experience.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdragonstudio-store%2Fds-ads-ultimate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdragonstudio-store%2Fds-ads-ultimate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdragonstudio-store%2Fds-ads-ultimate/lists"}