From 737bc5ae0fae8219f05475cb65167a23faec863e Mon Sep 17 00:00:00 2001 From: mckaygerhard Date: Tue, 20 Jun 2023 00:20:30 -0400 Subject: [PATCH] update information for engines any version, adde complete good readme --- README.md | 69 ++++++++++++++++++++++++++++++++++++++----------- description.txt | 1 + mod.conf | 2 +- 3 files changed, 56 insertions(+), 16 deletions(-) create mode 100644 description.txt diff --git a/README.md b/README.md index a098aa4..25d5d72 100644 --- a/README.md +++ b/README.md @@ -1,32 +1,70 @@ -# HUD bars +# minetest HUD bars + +HUD mod to display as bars and API for + +## Information +-------------- -## Description This mod changes the HUD of Minetest. It replaces the default health and breath -symbols by horizontal colored bars with text showing the number. +symbols by horizontal colored bars with text showing the number (or more configured one). Furthermore, it enables other mods to add their own custom bars to the HUD, this mod will place them accordingly. -**Important**: Keep in mind if running a server with this mod, that the custom -position should be displayed correctly on every screen size. +![](screenshot.png) + +## TEchnical info +----------------- + +> **Warning** Keep in mind if running a server with this mod, +that the custom position should be displayed correctly on every screen size. + +#### Dependencies + +There's no depends + +#### Current version + +The current version is 2.3.4.0 its a plus fork from original cos current +minetest most close mods developers are not so open to support already working servers. -## Current version -The current version is 2.3.4. It works for Minetest 0.4.17+ (maybe 0.4.16 too) or later. -This software uses [semantic versioning](http://semver.org), as defined by version 2.0.0 of the SemVer -standard. +#### Settings -## Settings This mod can be configured quite a bit. You can change HUD bar appearance, offsets, ordering, and more. Use the advanced settings menu in Minetest for detailed configuration. -## API +| configuration name | Description | type | values, min/default/max | +| ---------------------------- | ------------------------------------- | ---- | ------------------------ | +| hudbars_bar_type | HUD bars style | enum | progress_bar progress_bar,statbar_classic,statbar_modern | +| hudbars_autohide_breath | Automatically hide breath indicators | bool | true | +| hudbars_alignment_pattern | HUD bars alignment pattern | enum | zigzag zigzag,stack_up,stack_down | +| hudbars_sorting | HUD bars order | string | breath=1, health=0 | +| hudbars_pos_left_x | Left HUD bar screen x position | float | 0.5 0.0 1.0 | +| hudbars_pos_left_y | Left HUD bar screen y position | float | 1.0 0.0 1.0 | +| hudbars_pos_right_x | Right HUD bar screen x position | float | 0.5 0.0 1.0 | +| hudbars_pos_right_y | Right HUD bar screen y position | float | 1.0 0.0 1.0 | +| hudbars_start_offset_left_x | Left HUD bar x offset | int | -175 | +| hudbars_start_offset_left_y | Left HUD bar y offset | int | -86 | +| hudbars_start_offset_right_x | Right HUD bar x offset | int | 15 | +| hudbars_start_offset_right_y | Right HUD bar y offset | int | -86 | +| hudbars_start_statbar_offset_left_x | Left HUD statbar x offset | int | -265 | +| hudbars_start_statbar_offset_left_y | Left HUD statbar y offset | int | -90 | +| hudbars_start_statbar_offset_right_x | Right HUD statbar x offset | int | 25 | +| hudbars_start_statbar_offset_right_y | Right HUD statbar y offset | int | -90 | +| hudbars_vmargin | Vertical distance between HUD bars | int | 24 0 | +| hudbars_tick | Default HUD bars update interval | float | 0.1 0.0 4.0 | + +#### API + The API is used to add your own custom HUD bars. -Documentation for the API of this mod can be found in `API.md`. +Documentation for the API of this mod can be found in [`API.md`.](API.md) ## Legal -### License of source code + +#### License of source code + Author: Wuzzy (2015) Also: This mod was forked from the “Better HUD” [hud] mod by BlockMen. @@ -46,7 +84,7 @@ This program is free software. It comes without any warranty, to the extent permitted by applicable law. You can redistribute it and/or modify it under the terms of the MIT License. -### Licenses of textures +#### Licenses of textures * `hudbars_icon_health.png`—celeron55 (CC BY-SA 3.0), modified by BlockMen * `hudbars_bgicon_health.png`—celeron55 (CC BY-SA 3.0), modified by BlockMen @@ -56,7 +94,8 @@ and/or modify it under the terms of the MIT License. * `hudbars_bar_breath.png`—Wuzzy (MIT License) * `hudbars_bar_background.png`—Wuzzy (MIT License) -### License references +#### License references * [CC-BY-SA 3.0](https://creativecommons.org/licenses/by-sa/3.0/) * [MIT License](https://opensource.org/licenses/MIT) + diff --git a/description.txt b/description.txt new file mode 100644 index 0000000..726453c --- /dev/null +++ b/description.txt @@ -0,0 +1 @@ +HUD mod to display as bars and API for \ No newline at end of file diff --git a/mod.conf b/mod.conf index 5fa238a..d6a0571 100644 --- a/mod.conf +++ b/mod.conf @@ -1,2 +1,2 @@ name = hudbars -description = Replaces the health and breath symbols in the HUD by “progress bars” and shows exact values. Other mods can add more progress bars for custom player stats. +description = HUD mod to display as bars and API for