A Minetest mod which replaces the default health and breath bar by nice-looking HUD bars and provides a powerful API for modders to add custom HUD bars. https://content.minetest.net/packages/Wuzzy/hudbars/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

120 lines
7.1KB

  1. [Appearance]
  2. # Specifies how the value indicators (i.e. health, breah, etc.) look. There are 3 styles
  3. # available. You can choose between the default progress-bar-like bars and the good
  4. # old statbars like you know from vanilla Minetest.
  5. # These values are possible:
  6. # - progress_bar: A horizontal progress-bar-like bar with a label, showing numerical value
  7. # (current, maximum), and an icon. These bars usually convey the most
  8. # information. This is the default and recommended value.
  9. # - statbar_classic: Classic statbar, like in vanilla Minetest. Made out of up to 20
  10. # half-symbols. Those bars represent the vague ratio between
  11. # the current value and the maximum value. 1 half-symbol stands for
  12. # approximately 5% of the maximum value.
  13. # - statbar_modern: Like the classic statbar, but also supports background images, this
  14. # kind of statbar may be considered to be more user-friendly than the
  15. # classic statbar. This bar type closely resembles the mod
  16. # “Better HUD” [hud] by BlockMen.
  17. hudbars_bar_type (HUD bars style) enum progress_bar progress_bar,statbar_classic,statbar_modern
  18. # If enabled (default), the breath indicators in the HUD will be automatically hidden shortly
  19. # after the breath has been filled up. Otherwise, the breath will always be displayed.
  20. hudbars_autohide_breath (Automatically hide breath indicators) bool true
  21. # This setting changes the way the HUD bars are ordered on the display. You can choose
  22. # between a zig-zag pattern (default) or a vertically stacked pattern.
  23. # The following values are allowed:
  24. # - zigzag: Starting from the left bottom, the next is right from the first,
  25. # the next is above the first, the next is right of the third, etc.
  26. # - stack_up: The HUD bars are stacked vertically, going upwards.
  27. # - stack_down: The HUD bars are stacked vertically, going downwards.
  28. hudbars_alignment_pattern (HUD bars alignment pattern) enum zigzag zigzag,stack_up,stack_down
  29. # This setting allows you to specify the order of the HUD bars explicitly. If left empty
  30. # (the default), the health and breath indicators come first, additional indicators
  31. # may appear in any order. This setting is quite technical and normal users probably do not
  32. # need to worry about it.
  33. #
  34. # Syntax:
  35. # The setting has to be specified as a comma-seperated list of key=value pairs, where a key
  36. # refers to the identifier of a HUD bar and the value refers to the slot number of where the
  37. # HUD bar should be placed. The slot number must be an integer greater of equal to 0. Where
  38. # the HUD bars will be displayed exactly depends on the alignment pattern being used.
  39. # All HUD bars to which no order value has been applied will fill in all slots which have
  40. # not been occupied by the HUD bars specified in this setting, the slots will be filled in
  41. # from the lowest slot number.
  42. # Note that the order of those remaining HUD bars is not fixed, it basically just boils
  43. # down on which mod “came” first. Don't worry, the mod will still work perfectly fine, this
  44. # setting is entirely optional.
  45. # The identifier for the health bar is “health” and the identifier for the breath bar is
  46. # “breath”. For other HUD bars, you have to learn it from the mod which is supplying them.
  47. #
  48. # Be careful not to use slot indices twice, or else different HUD bars will be drawn over
  49. # each other!
  50. #
  51. # Example: “breath=0, health=1”
  52. # This makes the breath bar first and the health bar second, which is the opposite order
  53. # of the default one.
  54. hudbars_sorting (HUD bars order) string
  55. [Positions and offsets]
  56. # Horizontal (x) main position of the HUD bars over the entire screen.
  57. # 0.0 is left-most, 1.0 is right-most.
  58. # For the zig-zag alignment pattern, this is for the left HUD bars.
  59. hudbars_pos_left_x (Left HUD bar screen x position) float 0.5 0.0 1.0
  60. # Vertical (y) main position of the HUD bars over the entire screen.
  61. # 0.0 is top, 1.0 is bottom.
  62. # For the zig-zag alignment pattern, this is for the left HUD bars.
  63. hudbars_pos_left_y (Left HUD bar screen y position) float 1.0 0.0 1.0
  64. # Horizontal (x) main position of the right HUD bars over the entire screen.
  65. # 0.0 is left-most, 1.0 is right-most.
  66. # Only used for the zig-zag alignment pattern.
  67. hudbars_pos_right_x (Right HUD bar screen x position) float 0.5 0.0 1.0
  68. # Vertical main position (y) of the right HUD bars over the entire screen.
  69. # 0.0 is top, 1.0 is bottom.
  70. # Only used for the zig-zag alignment pattern.
  71. hudbars_pos_right_y (Right HUD bar screen y position) float 1.0 0.0 1.0
  72. # Precise x offset in pixels from the basic screen x position of the HUD bars.
  73. # For the zig-zag alignment pattern, this is for the left HUD bars.
  74. # This setting is used for the progress bar HUD bar style.
  75. hudbars_start_offset_left_x (Left HUD bar x offset) int -175
  76. # Precise y offset in pixels from the basic screen y position of the HUD bars.
  77. # For the zig-zag alignment pattern, this is for the left HUD bars.
  78. # This setting is used for the progress bar HUD bar style.
  79. hudbars_start_offset_left_y (Left HUD bar y offset) int -86
  80. # Precise x offset in pixels from the basic screen x position of the right HUD bars.
  81. # Only used for the zig-zag alignment pattern.
  82. # This setting is used for the progress bar HUD bar style.
  83. hudbars_start_offset_right_x (Right HUD bar x offset) int 15
  84. # Precise y offset in pixels from the basic screen y position of the right HUD bars.
  85. # Only used for the zig-zag alignment pattern.
  86. # This setting is used for the progress bar HUD bar style.
  87. hudbars_start_offset_right_y (Right HUD bar y offset) int -86
  88. # Precise x offset in pixels from the basic screen x position of the HUD statbars.
  89. # For the zig-zag alignment pattern, this is for the left HUD statbars.
  90. # This setting is used for the classic and modern statbar styles.
  91. hudbars_start_statbar_offset_left_x (Left HUD statbar x offset) int -265
  92. # Precise y offset in pixels from the basic screen y position of the HUD statbars.
  93. # For the zig-zag alignment pattern, this is for the left HUD statbars.
  94. # This setting is used for the classic and modern statbar styles.
  95. hudbars_start_statbar_offset_left_y (Left HUD statbar y offset) int -90
  96. # Precise x offset in pixels from the basic screen x position of the right HUD statbars.
  97. # Only used for the zig-zag alignment pattern.
  98. # This setting is used for the classic and modern statbar styles.
  99. hudbars_start_statbar_offset_right_x (Right HUD statbar x offset) int 25
  100. # Precise y offset in pixels from the basic screen y position of the right HUD statbars.
  101. # Only used for the zig-zag alignment pattern.
  102. # This setting is used for the classic and modern statbar styles.
  103. hudbars_start_statbar_offset_right_y (Right HUD statbar y offset) int -90
  104. # The vertical distance between two HUD bars, in pixels.
  105. hudbars_vmargin (Vertical distance between HUD bars) int 24 0
  106. [Performance]
  107. # The of seconds which need to pass before the server updates the default HUD bars
  108. # (health and breath). Increase this number if you have a slow server or a slow network
  109. # connection and experience performance problems.
  110. hudbars_tick (Default HUD bars update interval) float 0.1 0.0 4.0