1220 posts
Earth orbit
Posted 04 April 2015 - 08:03 PM
InnKeeper is a basic hotel/base room/door management system for use with the biometric locks in Gopher's Peripherals.
At its most basic level, it allows you to assign scanners to rooms. From there, you add guests to the rooms and they are automatically added to that room's scanners.
InnKeeper supports up to 999 rooms; with up to four scanners, five guests, and five messages/notes assigned to a room. Staff members are added via settings and are automatically added to all scanners in the system.
InnKeeper also features a simple guest search built-in: Find any guest, and their room number, quickly and easily.
Much like real business software, InnKeeper is slightly obtuse and poorly documented. But the support should be OK.
(While this picture shows two biolocks per door, only one biolock is *required* per door. A single biolock can be used for entry and a pressure plate can be used for exit)
[attachment=2197:Typical Setup.jpg]
Main Screen …. Settings Screen
[attachment=2198:MainScreen.png] [attachment=2199:SettingsScreen.png]
Search Screen .. Room Screen
[attachment=2200:SearchResults.png] [attachment=2201:RoomScreen.png]
ComputerCraft 1.73-1.75 (or 1.58)
Gopher's Peripherals 2.2 (or 2.13)
Advanced Computer
At least 1 biolock
As always, my sincere gratitude and thanks to everyone who made this possible; especially Gopher and Lyqyd for both of their work on Gopher's Peripherals! Special thanks to theoriginalbit for his custom read function.
At its most basic level, it allows you to assign scanners to rooms. From there, you add guests to the rooms and they are automatically added to that room's scanners.
InnKeeper supports up to 999 rooms; with up to four scanners, five guests, and five messages/notes assigned to a room. Staff members are added via settings and are automatically added to all scanners in the system.
InnKeeper also features a simple guest search built-in: Find any guest, and their room number, quickly and easily.
Much like real business software, InnKeeper is slightly obtuse and poorly documented. But the support should be OK.
Spoiler
Typical Setup(While this picture shows two biolocks per door, only one biolock is *required* per door. A single biolock can be used for entry and a pressure plate can be used for exit)
[attachment=2197:Typical Setup.jpg]
Main Screen …. Settings Screen
[attachment=2198:MainScreen.png] [attachment=2199:SettingsScreen.png]
Search Screen .. Room Screen
[attachment=2200:SearchResults.png] [attachment=2201:RoomScreen.png]
Spoiler
Minecraft 1.7.10 (or 1.6.4)ComputerCraft 1.73-1.75 (or 1.58)
Gopher's Peripherals 2.2 (or 2.13)
Advanced Computer
At least 1 biolock
Spoiler
Not all of InnKeeper's features are apparent or obvious at first. Some important things to know:
- Left click the big X at the top right of a screen to exit that screen
- Right click the big X at the top right of the main screen to password lock the program
- Left click the light gray room number field in any room screen to change the room number
- Left click the gray '#' to the right of the room # in any room screen to reorder your rooms
- Room # and room order are stored separately - room # does not affect room order and room order does not affect room #
- All 'paged' dialogues (room list, staff list, scanner list, search results) can be scrolled with the mouse wheel
- Pop-up dialogues with no input fields or buttons can be dismissed with a click of the mouse
- Click on the page number in the main screen to select a page to jump to (feature available when there is more than 1 page)
- The first time a room is added, it should have 1 or more scanners assigned to it before being marked 'Available'
- A reminder note is created in each new room's messages section to this effect
- InnKeeper does it's best to minimize the steps necessary to complete certain tasks...
- For example, setting a room to 'Available' will clear all guests and notes/messages automatically
- Setting a room to 'Unavailable' will clear all guests and prevent the addition of new guests, notes/messages will be preserved
- Adding a guest to an 'Available' room will automatically put that room into 'Reserved' status
- When a room is marked 'Occupied' the Check-IN time will be logged and displayed in the room property sheet automatically
- When a room is marked 'Checkout' the check-OUT time will be logged and displayed in the room property sheet automatically
- If a guest chooses to stay after already initiating checkout, simply place the room back in 'Occupied' status and the original Check-IN time will be preserved
- An occupied room may be marked for 'Service' - no changes will be made to the data
- New guests and staff need to be scanned in while the new guest/staff dialogue is open
- The guest count shows all guests in occupancy (reserved rooms are not included)
- Guests can be looked up by name with the search feature
- Searching for ? will show basic search help
- Searching for * will show all guests in occupancy and reservation status
- This means search results can total higher than occupancy count
- Searching for *o will show all guests in occupancy only
- Searching for *r will show all guests in reservation only
- Guests or staff members listed in red are in the InnKeeper database, but not programmed into the associated scanner(s)
- This is normal behavior for guests in Reserved rooms - guests aren't added to the scanners until the room is marked Occupied
- It is possible to remove all scanners from a room in any state ('Occupied', 'Service', etc.) - room state will not change
- This allows scanners to be reassigned as necessary without reseting all data
- Be careful when doing this, it is possible to leave an occupied room without any assigned scanners
- While the default number of users per scanner (for the physical biolock) is limited to 16 accounts per scanner this can be increased by editing the config for Gopher's Peripherals
- InnKeeper does NOT limit the number of staff that can be added - keep this in mind when adding staff members...
- any more than 11 staff and you won't be able to add the full 5 guests to a room's scanners unless the Gopher's Perihperals config file is edited to allow more accounts per scanner
- Upon startup InnKeeper looks for both its settings file and its room assignments file - if either is missing, Innkeeper preserves any data found and initiates first time setup
- InnKeeper LOCKS all scanners with the master scanner password to prevent unauthorized reprogramming
- If you wish to use the scanners elsewhere you'll need to unlock them in order to reprogram them
- This can be accomplished, on a per scanner basis or en masse, with BioPup
Spoiler
- ComputerCraft network cables are limited to 256 segments per network (iirc) so this will limit the size and scope of larger builds - the 'repeat' program can be used to extend this limit by placing 'repeater' computers between segments as needed.
- InnKeeper is a single computer solution, so larger or busier locations may wish to manage their facility with multiple computers each running their own copy of InnKeeper and each managing a portion of the facility
- InnKeeper does not encrypt the passwords selected during setup - they are stored in plain text
- InnKeeper only supports a single state per room - for example, a room that is occupied can not also be reserved for the next guest simultaneously
- InnKeeper doesn't have a timed messaging system (so no automatic wake up calls, etc.)
- InnKeeper checks for missing and rogue scanners on startup, but does not do checks during operation
- Guests are assigned per room - there is no 'main' guest list and no direct way to move guests between rooms
- Rooms, however, may be renumbered and reordered, and scanners may be assigned/de-assigned as necessary
- All changes (additions/removals/etc) are made in 'real-time' - there is no save or undo
- The following are enforced limitations based on room status:
- A room marked 'Unavailable' will not allow guests to be added or removed
- A room marked 'Service' or will not allow guests to be added but will allow them to be removed
- A room marked 'Occupied', 'Reserved', 'Checkout', or 'Service' will not allow the daily rate to be changed
- Only a room marked 'Available' or 'Unavailable' may have its daily rate changed or be deleted
As always, my sincere gratitude and thanks to everyone who made this possible; especially Gopher and Lyqyd for both of their work on Gopher's Peripherals! Special thanks to theoriginalbit for his custom read function.
Edited on 12 December 2016 - 04:34 AM
