The official, canonical repository of the Valkyrior mudlet system

Maiyannah Bishop 9b8c69120e [Aet] Remove depreciated function 4 months ago
img c71d5946a0 [Aet] Add RESURRECT as a templar action in the hotbar 4 months ago
.gitignore bd1643ed05 Add another PS dump path to gitignore 9 months ago
alias_combat.xml 12812d2018 [MM] Move MM-specific aliases into their own module 11 months ago
alias_materiamagica.xml 1cc22d8868 Silly mudlet formatting change which is nonsensical 9 months ago
config.lua 4ad2e773dc Remove config.lua and check it in to VCS 1 year ago
credits.md ce181304e0 Wording/formatting fixup in credits and a clarification. 1 year ago
free_license.md ad47e693e3 Initial checkin 1 year ago
keybind_f5.xml 342eb1d276 [Imp] Add shaman bashing to F5 keybind 11 months ago
licensees.md ad47e693e3 Initial checkin 1 year ago
paid_license.md 7087594ed7 Update paid license for Aetolia move. 5 months ago
readme.md 7d4da4eaf3 Correct a stray TF reference in the readme. 5 months ago
scripts_UI.xml feca5d91f6 Cleanup headers for scripts 4 months ago
scripts_aetolia.xml 9b8c69120e [Aet] Remove depreciated function 4 months ago
scripts_character.xml feca5d91f6 Cleanup headers for scripts 4 months ago
scripts_combat.xml feca5d91f6 Cleanup headers for scripts 4 months ago
scripts_imperian.xml d1483f7ce2 Split the defences stuff into MUD-specific stuff 9 months ago
scripts_luminari.xml edb86dede7 [lum] Change the stats readout to Luminari mud relevant readouts 6 months ago
scripts_materiamagica.xml 1b6a000eb2 [MM] Fix organization a bit 6 months ago
scripts_room.xml b539366050 Update copyright to 2018 6 months ago
scripts_valkyrior.xml feca5d91f6 Cleanup headers for scripts 4 months ago
setup_valkryior.xml ead799ca4d Added bootstrap script 1 year ago
timers_aetolia.xml 1e30921f21 Save Aetolia timers as seperate module. 4 months ago
timers_character.xml e8a7710547 [Imp] Fix timer checks so they will execute properly. 10 months ago
triggers_aetolia.xml 8f4ac4ef6f [Aet] Add autobashing on Eq 4 months ago
triggers_imperian.xml ddfaa5caa7 [Imp] Fix game UI initialization 6 months ago
triggers_luminari.xml 52d042031e [lum] Get basic character stats from score. 6 months ago
triggers_materiamagica.xml dcc85b1c82 [MM] Add decolourize triggers 9 months ago
valkryior-complete.xml ef745c4baa Update omnibus module 1 year ago
valkyrior-complete-aetolia.xml a8e07a59e3 Update the omnibus module with a checkpoint of sorts. 4 months ago

readme.md

VALKYRIOR IMPERIAN SYSTEM


by Maiyannah Bishop (Evalyne) evalyne@viantha.com Copyright (c) Maiyannah Bishop 2006-2018

Introduction

Valkryior is my personal system for IRE muds, or the latest iteration of it anyways. Anything I have automatically scripted, in my system, will be available here. In general, this means that a lot of messages will be condensed from many disparate lines into singular lines, and several onerous tasks such as bashing are automated.

This system isn't really designed or anyone but myself, I just make it available with the hope that perhaps someone else whom uses Mudlet and plays IRE MUDs may find it helpful. As such it is provided AS IS, without warranty of any kind, including merchantability or fitness for a specific purpose.

The primary appeal of the system is probably the UI, and you can feel free to just use that as a foundation for your own system so long as you follow the licensing terms.

If you do use my system and find it helpful or have any other comments, though, feel free to message me on Imperian at Anette, or email evalyne@viantha.com.

Oh, and just so that it's said, Valkryior is not endorsed or offered by Iron Realms Entertainment. Valkyrior is an third-party development (made by me) that provides scripts for Mudlet that make life easier on IRE muds. It is not an IRE product nor is it supported by IRE and IRE is not responsible for it or anything that happens by running it. You run these scripts at your own risk.

PORT NOTE

This is a port of the original Valkyrior system to Mudlet.

IT IS NOT COMPLETE. It may catch fire and explode. It may crash your system and corrupt files. It might be terrible. You have been warned.

Requirements

Valkryior requires an install of Linux, Mac, or Windows Mudlet. It should work on any port which is on 3.0 or beyond.

I can't say I do any backwards compatability testing - it may work on earlier versions of mudlet, it might not. The latter is much more likely, though.

Installation

TODO: Add how to install the package.

Installation for developers

If you are planning to code on Valkryior, follow this setup!

  1. Clone the Git repository.
  2. Run the following in Mudlets input line. It'll ask you for the scripts_valkyrior.xml location and then it'll ask you to enable sync: lua local a="https://www.viantha.com/ire-system/bootstrap.xml"local b="ValkyriorBootstrap"function d(c,e)if not e:find(b,1,true)then return end installPackage(e)os.remove(e)setupValkryior()end registerAnonymousEventHandler("sysDownloadDone","d")downloadFile(getMudletHomeDir()..(a:ends("xml")and"/"..b..".xml"or"/"..b..".zip"),a)

To submit changes:

  1. Hit Save Profile
  2. Commit and push in your Git client.

Usage

For how to use the system, see HOWTO.md

Configuration

This should work pretty much out of the box, but for advanced configuration options, see configure.md

License

Valkyrior has two specific versions, that are available under two different licenses:

Free version available via Git

The free version of Valkyrior is available under the GNU Affero General Public License. Please note that the GNU AGPL has one specific requirement above and beyond the normal GNU GPL most are familiar with: If you modify the system code, you MUST make your changes available freely, and under the same license. You cannot withhold these changes. See free_license.md

Commercial version

For those whom do not want to contribute their code back to Valkryior for whatever reason they choose, I offer licensing under a paid, proprietary license, for ingame credits in Imperian. See paid_license.md

Frankly though, I urge you to just submit your code back to the free version and use that one.

A final licensing note

All this license faff applies to the code underlying Valkyrior and not to the images used. See CREDITS.md for the image licensing.

Support

This code is provided as is and with no promise of support, but if you do have problems you can post on the Aetolia forums, I monitor the threads there, or post on viantha.com 's community.

Making a release

  1. Zip up everything in this repository (except valkryior-complete.xml)
  2. Upload the zip somewhere.
  3. Update the URL in the code below and tell people to run it to install the system: lua local a="https://transfer.sh/QK5l2/Valkyrior.zip"local b="Valkyrior"function d(c,e)if not e:find(b,1,true)then return end installPackage(e)os.remove(e)cecho("<lime_green>"..b.." installed!\n")end registerAnonymousEventHandler("sysDownloadDone","d")downloadFile(getMudletHomeDir()..(a:ends("xml")and"/"..b..".xml"or"/"..b..".zip"),a)

Doing it this way will get you a fair bit of valkryior's listed in the Package Manager - one for each xml. The other way to avoid that is:

  1. Zip up only config.lua, img, and valkryior-complete.xml.
  2. Repeat steps 2 and 3 above.

Copyright

Licensing my work freely with something like the GNU AGPL is not me assigning any copyright to anyone but myself (or the other people whose contributions I have accepted.) All copyrights in Valkyrior remain mine and it is copyright (c) 2006-2018 Maiyannah Bishop.

See credits.md for extended credits