Giter Club home page Giter Club logo

mausritter-sheet's Introduction

mausritter-sheet

Version License Mausritter Third Party Licence

Mausritter Character Sheet is a web application for Mausritter mice character sheet. You can use it, freely, from https://mausritter-sheet.dco.ninja.

Mausritter is about small-scale adventurers in a huge world. Mouse adventurers who take on big challenges and face down grave danger.

Have a look at Mausritter website and Licence.

Features

  • Play your mouse
  • Create a random mouse (implement Mouse creation rules from Mausritter Rules book),
  • Translated in English, Español, Deutsch and Français,
  • Manage hirelings,
  • Roll dices with/without advantage or disadvantage,
  • Drag'n'drop items or conditions on inventory slots
  • Drag'n'drop in grit.
  • Drag'n'drop in bank, retrieving item from bank cost 1% of its price.
  • History of dices and other actions.
  • Save and load whole character sheet from local storage. 12 slots are available. All data is saved in your browser, no server is needed.
  • Import / Export of character sheet. Use this to load a character into another browser.
  • Mouse can rest and advance in level, up to level 20.

Mausritter Sheet

See TODO.md for incoming features :-)

Exemple Sheet 0.1.1

Companions

Another Mausritter application is Mausritter-Colony. It's a minimalist tool to help GM to manage their game table.

Help wanted

Some help will be welcome to translate to other languages. Currently we have:

  • English by myself
  • French by myself
  • Spanish by CoyoteBlur
  • German by Keter150
  • Russian by Sorinqi

Installation (beta)

The desktop applications are in beta and should be used just for testing. They still contain bugs! They are available for Microsoft Windows, Apple Mac OS and GNU Linux. At this time, there is no mobile (Android or iOS) version.

To download, go to https://github.com/yar0d/mausritter-sheet/releases and search for the latest release named Application release.

For Translators

The folder /src/locales/ contains all messages files in a simple JSON format. To translate' you just have to copy a file by modifying its name with the language code you're targeting. By example, to translate to Spanish (Castilian), I copy conditions.en-US.json to conditions.es-ES.json, then en-US.json to es-ES.json, and so on.

A ISO Language Code Table exits to help you find the correct language code.

Translations is easy. JSON files contains message formatted like that:

  "original-message-in-english": "translation of the message in english"

You just have to translate the right part. Here is a short example, for French fr-FR:

  "Languages": "Langues",
  "Welcome to Mausritter Sheet!": "Bienvenue sur la fiche de personnage Mausritter !",

Note that the language name is translated into it's own language.

Exception for mouse-names

You just create a new mouse-names.??-??.json as described above. Translations is simple, you can replace every string by yours.

How to put your translations in mausritter-sheet

When all messages are translated, you can open an issue on the github with the label i18n and a title like I've translated to ;-). You can also contact me on discord at Yar0d#3470.

For developers

This application is made with Vue.js 3 and wave-ui.

For desktop application, I use Tauri.

Clone this repository and, install dependencies with yarn.

Development cycle

  1. Create a branch.
  2. Do the developer work :)
  3. Commit the stuff in branch.
  4. When it's ready, publish the branch git push --set-upstream origin BRANCH.
  5. Then create a public release the work with yarn run release:publish from the branch.
  6. Create a merge request, on github it's a pull request with base: main <- compare: BRANCH. Then merge it.
  7. To deploy, get the main branch with git checkout main ; git pull
  8. Build with yarn run build.
  9. Deploy the directory dist.

Update packages

yarn upgrade
npx tauri deps update

Compiles and hot-reloads for development

yarn serve

Compile and hot-reloads for desktop application

yarn serve:tauri

Lints and fixes files

yarn lint

Compiles and minifies for production

yarn build

Build a desktop application

yarn build:tauri

This will build a native application for your computer.

Build and run a docker container

If you use docker-compose:

docker-compose up --build

or, with docker:

yarn build:docker
yarn serve:docker

FTP deploy

  1. Publish a release with yarn release:publish
  2. Build with yarn build. We now have a dist folder.
  3. Send all content on the dist folder to your FTP server.

Create a release

A release will contains all binaries for MacOS, Windows and Linux.

  1. Increment application version with yarn release:publish on main branch.
  2. Create a pull request for base: release to compare: main.
  3. Merge this pull request. This will trigger publish action. It takes about 15 minutes to complete and have a draft of the release in https://github.com/yar0d/mausritter-sheet/releases.
  4. Edit the draft to your needs.

Customize configuration

See Configuration Reference.

mausritter-sheet's People

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

mausritter-sheet's Issues

Spanish Translation

Having a Spanish translation means a larger user base. I have very little prior experience with coding, but I'd be delighted to help with this if possible.

Create a dark theme

It can be cool to have a dark theme. Actual light theme is not convenient to play at night.

[internal] create a global inventory component.

To make maintenance easier and have an extensible component, create a global inventory component.
Properties:

  • can display paw (main/off paw). Defaut = true
  • number of rows for mouth. Default = 0
  • number of columns for mouth. Default = 0
  • number of rows for body. Default = 2
  • number of columns for body. Default = 1
  • number of rows for pack. Default = 2
  • number of columns for pack. Dfault = 3

Items can contains an inventory (like moonshore rat pack)

Safari does not display font

I speak french but I'm not sure for you. Bug : the writing not visible with the default font ("Broken script"). On OSX with latest Chrome. Same problem on mobile iOS with Safari. It works perfectly with "Frikster" font. Impossible/difficult to find de "preference" button without the text. I suggest to choose an other default font, because such a bug is critical for new player discovering your app, and the font change is very difficult (finding the preferences panel).

Fix: use another default font. Try a simple monospace.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.