Skip to content

Commit 1225111

Browse files
authored
release v1.6.0 (#92)
* docs: 🔖 advance local version to 1.5.0 * feat(discord): ✨ add Discord integration (#83) * docs: 🔖 advance local version to 1.5.0 (#81) * feat(discord): ✨ set Discord button to PR server invite * feat(discord): ✨ add client-side Discord Rich Text Integration announce game, player location, and elapsed time playing * docs: 🔖 advance local version to 1.5.0 (#81) (#84) * docs: 🔖 advance local version to 1.5.0 (#81) (#86) * docs(readme): ✏️ fix typo in UI Configuration * docs: 📝 credit Dalem * fix(emco): 💄 style tabs * build(version): 🔖 advance version to 1.5.1 * feat(chat): ✨ add timestamp * fix(mapper): 🐛 remove duplicate terrain keys * style(mapper): 🎨 format code with Prettier * style(PRS): 🎨 format code with Prettier * style(PRS): 🔖 advance version to 1.6.0 * style(chat): 🎨 format code with prettier * style(core): 🎨 format code with Prettier * style(stats): 🎨 format code with Prettier * docs(readme): 🔖 advance version to 1.6.0 * docs: 📝 add total downloads badge * style(readme): 🎨 format code with Prettier * fix(readme): 🐛 fix download badge markdown * fix(readme): ✏️ fix download badge typo * fix(readme): 🐛 fix download badge markdown * fix(readme): 🐛 fix layout prefs markdown * fix(readme): ✏️ fix contributors link anchor * feat(logo): 💄 add @H4RV3Y2805 logo * feat(readme): 💄 update banner
1 parent 9f304b6 commit 1225111

File tree

7 files changed

+1179
-641
lines changed

7 files changed

+1179
-641
lines changed

.github/images/prs-logo.png

20.5 KB
Loading

PRS.lua

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,15 @@
11
-- Procedural Realms Script (PRS) by Stack and Dalem
2-
3-
local version = "1.5.0"
2+
local version = "1.6.0"
43

54
-- check if the generic_mapper package is installed and, if so, uninstall it
6-
if table.contains(getPackages(),"generic_mapper") then
7-
uninstallPackage("generic_mapper")
5+
if table.contains(getPackages(), "generic_mapper") then
6+
uninstallPackage("generic_mapper")
87
end
98

109
-- Open the windows
1110
PRSchat.tabs()
1211
registerAnonymousEventHandler("gmcp.Char.player", function()
13-
PRSstats.stats()
12+
PRSstats.stats()
1413
end, true)
1514

1615
-- set Discord button to PR invite
@@ -22,4 +21,4 @@ setDiscordGame("Procedural Realms")
2221
local currentarea = getRoomArea(getPlayerRoom())
2322
local areaname = getAreaTableSwap()[currentarea]
2423
setDiscordDetail(areaname)
25-
setDiscordElapsedStartTime(os.time(os.date("*t")))
24+
setDiscordElapsedStartTime(os.time(os.date("*t")))

README.md

Lines changed: 32 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -4,45 +4,46 @@
44
<div>
55
<br />
66
<p align="left">
7-
<a href=".github/images/procrealms-mudlet-alt-4x.png">
8-
<img src=".github/images/procrealms-mudlet-alt-4x.png" alt="Procedural Realms Logo" width="auto" height="auto">
7+
<a href=".github/images/prs-logo.png">
8+
<img src=".github/images/prs-logo.png" alt="Procedural Realms Logo" width="auto" height="auto">
99
</a>
1010
</p>
1111
</div>
1212

13-
1413
<!-- PROJECT BADGES -->
15-
[![GitHub release (latest SemVer including pre-releases)](https://img.shields.io/github/v/release/iLPdev/prs?include_prereleases&sort=semver&style=flat-square)](https://github.com/iLPdev/prs/releases/latest) [![Issues][issues-shield]][issues-url] [![GPL License][license-shield]][license-url] [![standard-readme compliant][standard-readme-shield]][standard-readme-url]
16-
[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/Mudlet/Mudlet?style=flat-square&label=client&sort=semver)](https://github.com/Mudlet/Mudlet/releases/latest) <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
17-
[![All Contributors](https://img.shields.io/badge/all_contributors-4-orange.svg?style=flat-square)](#contributors-)
18-
<!-- ALL-CONTRIBUTORS-BADGE:END -->
14+
15+
[![GitHub release (latest SemVer including pre-releases)](https://img.shields.io/github/v/release/iLPdev/prs?include_prereleases&sort=semver&style=flat-square)](https://github.com/iLPdev/prs/releases/latest) [![Issues][issues-shield]][issues-url] ![Downloads][downloads-shield] [![GPL License][license-shield]][license-url] [![standard-readme compliant][standard-readme-shield]][standard-readme-url]
16+
[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/Mudlet/Mudlet?style=flat-square&label=client&sort=semver)](https://github.com/Mudlet/Mudlet/releases/latest) <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --><!-- ALL-CONTRIBUTORS-BADGE:END -->
17+
[![All Contributors](https://img.shields.io/badge/all_contributors-4-orange.svg?style=flat-square)](#contributors-)<!-- ALL-CONTRIBUTORS-BADGE:END -->
1918

2019
<!-- SHORT DESCRIPTION -->
2120
<p align="center">
2221
Mudlet script for Procedural Realms MUD
2322
<br />
2423
</p>
2524

26-
<!-- LONG DESCRIPTION -->
25+
<!-- LONG DESCRIPTION -->
26+
2727
The Procedural Realms Script [PRS] project gives [Procedural Realms MUD](http://textdimension.com/) players improved access to the advanced features of the [Mudlet](https://www.mudlet.org) MUD client. By leveraging the specific "out of band" packets sent by Procedural Realms' server, PRS uses Mudlet's mapper to identifies rooms/exits, prevent creation of duplicate rooms/areas, manage instanced areas, and accurately track your character's location on the map as you move about the realm. Additional convenience features include speedwalking/pathfinding, autosetting map terrain colors, self-updating gauges for vitals, communication containers, and a user-adjustable UI layout.
2828

2929
Project Link: [https://github.com/iLPdev/prs]<br />
3030
Mudlet Forum Topic: [https://forums.mudlet.org/viewtopic.php?f=6&t=23126]
3131

32-
3332
<!-- TABLE OF CONTENTS -->
33+
3434
## Table of Contents
3535

3636
- [Background](#background)
3737
- [Install](#install)
3838
- [Usage](#usage)
39-
- [Roadmap](#roadmap)
39+
- [Roadmap](#roadmap)
4040
- [Maintainer](#maintainer)
4141
- [Acknowledgements](#acknowledgements)
4242
- [Contributing](#contributing)
4343
- [License](#license)
44-
44+
4545
<!-- ABOUT THE PROJECT -->
46+
4647
## Background
4748

4849
<p> <!-- align="center"> -->
@@ -71,6 +72,7 @@ Mudlet Forum Topic: [https://forums.mudlet.org/viewtopic.php?f=6&t=23126]
7172
- Self-Updating Gauges for character vitals, including Hit Points, Energy, Stamina, Rage, Combo, and eXperience Points.
7273
- Speedwalking and pathfinding - Efficiently get where you're going - and fast!
7374
- Discord Rich Presence integration
75+
- Clickable URLs
7476

7577
### Built With
7678

@@ -86,24 +88,26 @@ Mudlet Forum Topic: [https://forums.mudlet.org/viewtopic.php?f=6&t=23126]
8688
Version numbering approximates the [Semantic Versioning](http://semver.org) approach.
8789

8890
### Project Status
91+
8992
<!-- Describe the current release and any notes about the current state of the project. Examples: currently compiles on your host machine, but is not cross-compiling for ARM, APIs are not set, feature not implemented, etc. -->
9093

9194
[![Status Ventis][status-ventis]][andivionian-status-classifier] ![Travis (.com) branch](https://img.shields.io/travis/com/iLPdev/discMapper/develop?style=flat)
9295

9396
- **Project State**: Procedural Realms Script is under active development. The application can be used, but may be unstable. We are in need of continued testing prior to moving forward with each new release.
9497

95-
- **Current Release**: v1.5.0
98+
- **Current Release**: v1.6.0
9699

97100
**[^Top](#table-of-contents)**
98101

99102
<!-- GETTING STARTED -->
103+
100104
## Install
101105

102106
The [Mudlet Makers](https://github.com/Mudlet/Mudlet/graphs/contributors) could not have made it easier to install preconfigured custom aliases, triggers, scripts, keybindings, and UIs.
103107

104108
### Automatic Install Method
105109

106-
Procedural Realms MUD will automatically detect that you've connected to the server via Mudlet and prompt you to install or update to the latest version of PRS by issuing the `mudlet install` command. You may then close and restart Mudlet to initialize the latest version of PRS. See the in-game `mudlet help` command for details.
110+
Procedural Realms MUD will automatically detect that you've connected to the server via Mudlet and prompt you to install or update to the latest version of PRS by issuing the `mudlet install` command. You may then close and restart Mudlet to initialize the latest version of PRS. See the in-game `mudlet help` command for details.
107111

108112
### Manual Install Method
109113

@@ -139,25 +143,28 @@ You can also clone the entire project directly with this command: `git clone git
139143
**[^Top](#table-of-contents)**
140144

141145
<!-- USAGE -->
146+
142147
## Usage
143148

144149
### User Interface Configuration
145150

146151
There are two fully configurable UI elements that are currently included in PRS by default: the EMCO (Communications Tabs and Map) and the Vitals (character Stat guages) windows. The UI windows are docked on the right of mudlet's main display upon connection to the game server. The windows may be resized by dragging their borders, moved by click/dragging their window title/headings, as well as undocked or closed by clicking on their respective upper-right pop-out or close icons.
147152

148-
<!-- 1. **Enable GMCP**: You must enable GMCP options on the game server. To determine if GMCP in enabled on the server, log into the game and issue the following command: `config gmcp`. Displayed under the "Terminal" column are the "gmcp" and "gmcpseenrooms" options. If they are not currently set to "on", you may enable them by issuing the `gmcp` and `gmcpseenroom` commands. -->
149-
1. **Resize Windows**: On initial usage, you will typically need to resize the windows both horizontally and vertically to reveal their contents fully. Note that the window configurations are preserved but not restored until connection to the game server has been established.
150-
2. **Layout Preferences: You can optionally drag, re-arrange, pop out, and otherwise move the two PRS windows to your liking.
153+
<!-- 1. **Enable GMCP**: You must enable GMCP options on the game server. To determine if GMCP in enabled on the server, log into the game and issue the following command: `config gmcp`. Displayed under the "Terminal" column are the "gmcp" and "gmcpseenrooms" options. If they are not currently set to "on", you may enable them by issuing the `gmcp` and `gmcpseenroom` commands. -->
154+
155+
1. **Resize Windows**: On initial usage, you will typically need to resize the windows both horizontally and vertically to reveal their contents fully. Note that the window configurations are preserved but not restored until connection to the game server has been established.
156+
2. **Layout Preferences:** You can optionally drag, re-arrange, pop out, and otherwise move the two PRS windows to your liking.
151157

152158
### Command Line Interface
153159

154160
- A command line interface exists at the bottom of the `Chat`, `Newbie`, `Trade`, and `Local` tabs within the EMCO window. To communicate through any of these channels, simply click on the empty bottom line of the tab and input your text to be sent through the corresponding communication channel.
155161

156-
- **@tell** - You may communicate privately with another player via the game's `tell` command from within any of the EMCO communication tabs' CLI via `@<player name> <message>`. For example, entering `@stack blah foo` into a tab's CLI will issue `tell stack blah foo` to the game server.
162+
- **@tell** - You may communicate privately with another player via the game's `tell` command from within any of the EMCO communication tabs' CLI via `@<player name> <message>`. For example, entering `@stack blah foo` into a tab's CLI will issue `tell stack blah foo` to the game server.
157163

158164
**[^Top](#table-of-contents)**
159165

160166
<!-- ROADMAP -->
167+
161168
## Roadmap
162169

163170
The primary objective is to develop and test a minimally viable package for Mudlet that meets the requirements for includion on the list of connectable games when Mudlet starts and, in turn, to increase the playerbase of Procedural Realms.
@@ -169,13 +176,15 @@ See also the [open issues](https://github.com/iLPdev/prs/issues) for a list of p
169176
**[^Top](#table-of-contents)**
170177

171178
<!-- MAINTAINER(S) -->
179+
172180
## Maintainer
173181

174-
[@Stack](https://github.com/iLPdev) - Stop by and say hello on the [Procedural Realms Discord Server]([https://discordapp.com/invite/kuYvMQ9](https://discord.gg/rRFEjc6vV9))!
182+
[@Stack](https://github.com/iLPdev) - Stop by and say hello on the [Procedural Realms Discord Server](<[https://discordapp.com/invite/kuYvMQ9](https://discord.gg/rRFEjc6vV9)>)!
175183

176184
**[^Top](#table-of-contents)**
177185

178186
<!-- ACKNOWLEDGEMENTS -->
187+
179188
## Acknowledgements
180189

181190
<!-- State anyone or anything that significantly helped with the development of your project.
@@ -193,9 +202,10 @@ See also the [open issues](https://github.com/iLPdev/prs/issues) for a list of p
193202
**[^Top](#table-of-contents)**
194203

195204
<!-- CONTRIBUTING -->
205+
196206
## Contributing
197207

198-
Contributions are what make the open source community such an amazing space to be learn, inspire, and create. Any contributions you make are **greatly appreciated** -- that’s the main reason discMapper is open-sourced! There are so many ways to contribute, even if you’re not a technical person. All contributions--no matter how small---are always welcome.
208+
Contributions are what make the open source community such an amazing space to be learn, inspire, and create. Any contributions you make are **greatly appreciated** -- that’s the main reason discMapper is open-sourced! There are so many ways to contribute, even if you’re not a technical person. All contributions--no matter how small---are always welcome.
199209

200210
See the [open issues](https://github.com/iLPdev/prs/issues) for a list of ideas, questions, proposed features, and known issues.
201211

@@ -257,6 +267,7 @@ Thanks go to these amazing folks ([emoji key](https://allcontributors.org/docs/e
257267
**[^Top](#table-of-contents)**
258268

259269
<!-- LICENSE -- Must be last section. -->
270+
260271
## License
261272

262273
Copyleft (2023) _iLP development_. Distributed under GPL v3.0-and-later. For more
@@ -266,6 +277,7 @@ information, see [`LICENSE`](https://github.com/iLPdev/prs/blob/main/LICENSE).
266277

267278
<!-- MARKDOWN LINKS & IMAGES -->
268279
<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
280+
269281
[contributors-shield]: https://img.shields.io/github/contributors/iLPdev/prs.svg?style=flat-square
270282
[contributors-url]: https://github.com/iLPdev/prs/graphs/contributors
271283
[forks-shield]: https://img.shields.io/github/forks/iLPdev/prs.svg?style=flat-square
@@ -282,3 +294,4 @@ information, see [`LICENSE`](https://github.com/iLPdev/prs/blob/main/LICENSE).
282294
[status-ventis]: https://img.shields.io/badge/status-ventis-yellow.svg
283295
[mudlet-url]: https://www.mudlet.org
284296
[ac-url]: https://github.com/all-contributors/all-contributors
297+
[downloads-shield]: https://img.shields.io/github/downloads/iLPdev/prs/total?style=flat-square

0 commit comments

Comments
 (0)