From ab7c0c925aa6f2405d4f0f018e4fd42d30857cd4 Mon Sep 17 00:00:00 2001 From: tanishisherewith <120117618+tanishisherewithhh@users.noreply.github.com> Date: Wed, 10 Apr 2024 16:50:23 +0530 Subject: [PATCH 1/3] Update README.md --- README.md | 69 +++++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 62 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 8108cd5..b0154d0 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,70 @@ -# DynamicHUD -A library to create HUD elements and display them on the screen. **Fabric only**\ -## Short introduction -Dynamic HUD is a library used to create and display "widgets" on the screen. +# DynamicHUD for Minecraft Fabric -Included widgets by the library are Armor Widget, Item Widget and Text Widget. +DynamicHUD is a special tool for Minecraft mod creators who use Fabric. It works with Minecraft 1.19.1 and newer versions. With DynamicHUD, you can make your own HUD parts that players can change and interact with, making their game look and feel better. +> _It may be ported back upto 1.16 fabric on demand._ -The library also includes basic utility features like a menu, slider and a Color Picker. Overall, this mod contains all the features you will need for a Hud editor. -## Note: This is a library meaning it does not do / display anything on its own, It is mainly to help other developers and ease of adding or displaying stuff on the screen +## Features +- **Automatic Loading & Saving**: Widgets automatically save their state and reload upon game restart, providing a seamless experience for players. +- **Dynamic Values**: Widgets can display real-time information, adapting to in-game events and data changes. +- **Inbuilt Widgets**: Start with `TextWidget` for easy text display and expand with more specialized widgets. +- **Utility Classes**: Utilize `DrawHelper`, `ColorHelper`, and `TextureHelper` for efficient and streamlined development. +- **ContextMenu**: A versatile context menu featuring boolean, slider, runnable, color options, and list/enum selections for comprehensive widget customization. +- **Screen Border Control**: Widgets are confined within the screen boundaries to prevent off-screen drift. +- **Multi-Mod Support**: Designed for compatibility and easy integration across various mods. +- **Easy Integration**: Simple setup for quick implementation into your projects. +- **Comprehensive Wiki**: A detailed guide and reference for all features of DynamicHUD, available at https://tanishisherewith.gitbook.io/dynamic-hud. + +## Disclaimer +DynamicHUD is a library for Minecraft Fabric designed to provide developers with the tools to create customizable HUD elements. It does not add widgets or any functionality on its own. Interaction with DynamicHUD's internals and utilization of its features can only be done through mods that implement this library. Users looking for in-game HUD elements should refer to mods that use DynamicHUD. + +*_This mod / library is fabric only and has no future plans to be ported to forge._* + +## Installation for Users + +To ensure mods that depend on DynamicHUD work correctly, follow these steps to add DynamicHUD to your Minecraft installation: + +0. Make sure you have [Fabric](https://fabricmc.net/) and [Fabric-API](https://modrinth.com/mod/fabric-api/) installed. +1. Download the `dynamichud-.jar` file from the official [release](https://modrinth.com/mod/dynamichud/versions) page. +2. Navigate to your Minecraft directory. The default path is usually: + - Windows: `%APPDATA%\.minecraft` + - macOS: `~/Library/Application Support/minecraft` + - Linux: `~/.minecraft` +3. Locate the `mods` folder within your Minecraft directory. If it doesn't exist, create it. +4. Place the downloaded DynamicHUD `.jar` file into the `mods` folder. +5. Run Minecraft with the Fabric loader. DynamicHUD will now be loaded, and any mods with DynamicHUD as a dependency can function properly. + +Enjoy the enhanced HUD experience provided by mods utilizing DynamicHUD! + +## Getting Started For Developers +> Visit our [wiki](https://tanishisherewith.gitbook.io/dynamic-hud) for more detailed information about the library! + +To integrate DynamicHUD into your mod, add it as a dependency in your `build.gradle` file: + +```groovy +allprojects { + repositories { + maven { url 'https://jitpack.io' } + } +} + +dependencies { + // Dynamic HUD + modImplementation 'com.github.V-Fast:DynamicHUD:' +} + +``` + +## Contributing +Contributions are welcome! If you’re interested in improving DynamicHUD or adding new features, please review our contributing guidelines. + +## License +DynamicHUD is released under the MIT License. Feel free to use and modify it in your mods, with proper attribution back to this repository. + +## Support +Need assistance or have suggestions? Join our [Discord](https://discord.com/invite/Rqpn3C7yR5) community or submit an issue on our GitHub [repository](https://github.com/V-Fast/DynamicHUD). # Examples - [_DynamicHUDtest.java_](src/main/java/com/tanishisherewith/dynamichud/DynamicHUDtest.java) From bab174c0eb7d1534380416aaa637c7e2281a9d6f Mon Sep 17 00:00:00 2001 From: tanishisherewith <120117618+tanishisherewithhh@users.noreply.github.com> Date: Wed, 10 Apr 2024 16:52:02 +0530 Subject: [PATCH 2/3] Update issue templates --- .github/ISSUE_TEMPLATE/bug_report.md | 32 +++++++++++++++++++++++ .github/ISSUE_TEMPLATE/feature_request.md | 20 ++++++++++++++ 2 files changed, 52 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 0000000..53860e1 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,32 @@ +--- +name: Bug report +about: Create a report to help us improve +title: "[BUG] Unknown" +labels: '' +assignees: '' + +--- + +**Describe the bug** +A clear and concise description of what the bug is. + +**To Reproduce** +Steps to reproduce the behavior: +1. Go to '...' +2. Click on '....' +3. Scroll down to '....' +4. See error + +**Expected behavior** +A clear and concise description of what you expected to happen. + +**Screenshots** +If applicable, add screenshots to help explain your problem. + +**Desktop (please complete the following information):** + - OS: [e.g. iOS] + - Browser [e.g. chrome, safari] + - Version [e.g. 22] + +**Additional context** +Add any other context about the problem here. diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 0000000..bbcbbe7 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,20 @@ +--- +name: Feature request +about: Suggest an idea for this project +title: '' +labels: '' +assignees: '' + +--- + +**Is your feature request related to a problem? Please describe.** +A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] + +**Describe the solution you'd like** +A clear and concise description of what you want to happen. + +**Describe alternatives you've considered** +A clear and concise description of any alternative solutions or features you've considered. + +**Additional context** +Add any other context or screenshots about the feature request here. From e487bffe18d297feb48079adb753377ab70412e6 Mon Sep 17 00:00:00 2001 From: tanishisherewith <120117618+tanishisherewithhh@users.noreply.github.com> Date: Wed, 10 Apr 2024 22:53:58 +0530 Subject: [PATCH 3/3] Snapping --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index b0154d0..4cb8b3a 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,7 @@ DynamicHUD is a special tool for Minecraft mod creators who use Fabric. It works - **Utility Classes**: Utilize `DrawHelper`, `ColorHelper`, and `TextureHelper` for efficient and streamlined development. - **ContextMenu**: A versatile context menu featuring boolean, slider, runnable, color options, and list/enum selections for comprehensive widget customization. - **Screen Border Control**: Widgets are confined within the screen boundaries to prevent off-screen drift. +- **Snapping**: Widgets automatically snap to a grid corner in a imaginary grid pattern on the screen when the shift key is pressed. - **Multi-Mod Support**: Designed for compatibility and easy integration across various mods. - **Easy Integration**: Simple setup for quick implementation into your projects. - **Comprehensive Wiki**: A detailed guide and reference for all features of DynamicHUD, available at https://tanishisherewith.gitbook.io/dynamic-hud.