Skip to content

HUDdson is a lightweight and reusable HUD (Heads-Up Display) library for IntyBASIC games.

License

Notifications You must be signed in to change notification settings

FrancescoGd/HUDdson

Repository files navigation

HUDdson

GitHub Repo License: LGPL v3 Latest Release

HUDdson is a lightweight and reusable HUD (Heads-Up Display) library for IntyBASIC games.

Source code: github.com/FrancescoGd/HUDdson

It provides simple procedures to display score, level, and other game information on screen.

Name Meaning

HUD: In video games, a Heads-Up Display is the layer of visual information shown on screen to provide the player with essential data without interrupting gameplay. Read more on Wikipedia

Huddson: Variant spelling of the English surname "Hudson", which means "son of Hudde", with "Hudde" being a medieval given name. Read more on Name Discoveries

Features

  • Easy integration into any IntyBASIC project
  • Clear and update HUD elements with simple procedure calls
  • Fully customizable positions and labels (TODO)

Usage

Include src/HUDdson.bas in your IntyBASIC project and call HudInit at game start. Update the HUD by calling HudUpdate whenever score or level changes.

For more details, see the Usage Guide and the Example Project.

License

HUDdson is released under the GNU Lesser General Public License v3.0 (LGPL-3.0).

This means:

  • ✅ You can use HUDdson in both open source and closed source (commercial) projects.
  • ✅ You can modify HUDdson for your needs.
  • 📢 If you distribute a modified version of HUDdson, you must make the modified source code of HUDdson available under the same LGPL-3.0 license.
  • ❌ You are not required to open source your entire project — only the changes made to HUDdson itself.

For the full legal text, see the LICENSE file or read it on the GNU website.

Release Scripts

This project includes helper scripts to automate changelog generation and tagging.

Prerequisites: git-cliff must be installed.

  • PowerShell:

    ./release.ps1 -Version <version>
  • Bash:

    make the script executable first

    chmod +x release.sh

    then

    ./release.sh <version>

Both scripts:

  • Generate the changelog using git-cliff’s default configuration
  • Commit the changes in Conventional Commits format
  • Create and push the release tag