Unscramble
Unscramble
Download Unscramble: v4.0
Source Code: GitHub
Make sure you have Vault and Essentials installed!
When updating to 4.0, delete your old config file and allow the plugin (Version 4.0) to generate a new one.
Description And Features
Unscramble is a fun game for your players to play. You enter a word, such as "diamond," and the plugin will scramble it for you and display the scrambled word to the general population of the server. All the players have to do is enter their guess into chat as many times as they want. The first person to correctly unscramble the word will get the reward you set.
Use "/us newgame w:[word] p:<prize> a:<amount> t:<Timer> h:<hint-interval> c:<category>" to start a new game
IMPORTANT! - REQUIRES VAULT
Permissions Support (Vault)
Unscramble uses Vault to look all of the following Permissions plugins:
- Permissions 3
- bPermissions
- PEX
- GroupManager
- PermissionsBukkit
- zPermissions
Vault is required for this plugin to work. Check out their page and download vault with the link below.
Dev Page: Vault Dev Page
Perm Nodes And Commands
Perm Node | Associated Command | Description |
---|---|---|
unscramble.welcome | /unscramble | The little welcome message and version number displayed |
unscramble.help | /unscramble help | The help menu that has all the commands |
unscramble.reload | /unscramble reload | Reload both the config.yml and extra.yml files |
unscramble.setscrambleseparately | /unscramble setscrambleseparately [true/false] | Sets the Scramble-Words-Separately to true/false |
unscramble.hint | /unscramble hint | Gives a hint on the current word. |
unscramble.cancel | /unscramble cancel | Cancels the current game. |
unscramble.claim | /unscramble claim | Gives perm to claim your prize |
unscramble.newgame | /unscramble newgame w:[word] | Starts a new game. |
unscramble.newgame.prize.# or unscramble.newgame.prize.* | /unscramble newgame w:[word] p:<prize> | Gives perm for a certain item ID (Ie, 264) or for ALL prizes |
unscramble.newgame.amount | /unscramble newgame w:[word] a:<amount> | Gives perm for the a: tag |
unscramble.newgame.timer | /unscramble newgame w:[word] t:<timer> | Gives perm for the t: tag |
unscramble.newgame.hintinterval | /unscramble newgame w:[word] h:<hint-interval> | Gives perm for the h: tag |
unscramble.newgame.category | /unscramble newgame w:[word] c:<category> | Gives perm for the c: tag |
Screenies
In this one, a game was created (The word being "minecraft") and no one guessed it. The time ran out and the game expired.
Just the two lines of a new game being created.
In this one, the game was created and I happened to guess the word being time expired. There was a short announcement of my win, and a diamond was added to my inventory.
Here, I did multiple guesses, but didn't spell the word correctly on the first couple of attempts. This also demonstrates how the admin running the game can use /us hint to reveal random letter in the word.
Tutorial
The main command of the game is the /us newgame command. The syntax is: /us newgame w:[word] p:<prize> a:<amount> t:<Timer> h:<hint-interval> c:<category>
[] is mandatory, <> is optional
Word (w:) - The word is the word or phrase you want to play unscramble with. Enter word in it's unscrambled form. If you want to enter a multiple word phrase, use underscores instead of spaces. For example: /us newgame multiple_word_phrase 264 1. FOR A RANDOM WORD, USE THE WORD "RANDOM"
Prize (p:) - The prize is what the winnder will receive when they correctly unscramble the word/phrase. It currently only supports item ID NUMBERS. For example, 264 is the item ID for diamond. You can also enter "$" (Dollar Sign) to use currency as the prize. Using currency means you have to have a currency plugin such as EssentialsEco, iConomy, or BOSEconomy.
Amount (a:) - This is the amount of items or money that will be given. If you enter 264 for prize, and then 1 for amount, it will give 1 diamond. If you entered the dollar sign for prize, then this will be the amount. For example: /us newgame word_to_be_unscrambled $ 1000. This will give 1000 game currency upon it's completion.
Timer (t:) - This is an option component to the game. You can set a time variable that will count down. After time has finished, no more answers will be accepted. Time is in seconds only.
Hint Interval (h:) - This is an option to automatically give hints every X amount of seconds
Category (c:) - Is like a theme, or general area of what the word is. (IE, "c:cars" when the word is lambo)
FOR A RANDOM WORD FROM THE CONFIG.YML LIST, USE THE WORD "RANDOM" FOR W:
Donate?
Like what I do? Buy me a beer!
I put a lot of time into coding, testing, and updating my plugins. I even do specialized plugins for people when they PM me (For free). If you love my plugins, this is a way to say thank you.
Change Log
Version 4.0 (June 7th, 2015)
- Big update!
- Added automatic games
- New way of storing words for random games
- Equations to determine rewards based on number of letters in words
- Added a config file
- Support for spigot 1.8.7
Version 3.0 (October 26th, 2012)
- Increased delay of "congrats" message
- Added /us claim with perm node
- Added auto hints
- Added category/theme variable
- Added auto update check
- Fixed $ problem
Version 2.1 (September 2nd, 2012)
- Increased delay of "congrats" message
- Fixed error with timer
- Still problem with factions.
Version 2.0 (August 30th, 2012)
- Fixed problem with Essentials Chat
Version 1.0 (July 27th, 2012)
- Initial Release
Any chance you will start supporting 1.7.10 bukkit thermos servers?
Thank you Hot for updating it! Now I'll add it to my server, for anyone that is wondering about unscramble it's a great plugin. Players really enjoy it.
@walster001
As in /us newgame w:RANDOM p:RANDOM a:1 t:30
Could you have a random prize given out say p:RANDOM so that it would make it more interesting!
@TheRynoMyte
At the moment there is not, but that's a great idea and I'll definitely look into it.
Love the plugin and have been using for over a year, have it hooked to variable triggers so players can start a game by pressing a button at spawn region. Now my question is, is there a way to make more than one random word folder? so i can set category and them folders for play as well. like have a folder such as the random one but call Minecraft (since its MC items), then one called movies, famous people, music, etc etc?
@xxxteslaxxx
Workload is weaning for me, so Im planning on updating all my plugins, including this one.
I sent you a PM with my email if you wanna get a hold of me.
@Hotshot2162
Sorry, I haven't checked this site in a while, since I hadn't heard from you.
Yes, you have my permission to merge the plugins, though I would like an issue, mentioned previously, to be addressed (related to a prize of money). Also, with the release of Minecraft 1.7.2, does the handling of prizes (their identification) need to change?
I will have some time soon (over the holidays) for some development, especially if you need help. Thanks.
@xxxteslaxxx
I would love to merge our two plugins!
If you're fine with it, we could merge them and put them up on this page. I would of course make you a contributor and author, and grant you permission to edit and make changes to this page and the plugin itself.
Hotshot2162,
Where do we go from here? Did you get a chance to look at my code?
If you're busy, I wouldn't mind tracking down the '$' prize issue I'm seeing in Unscramble. It might be an issue with my setup, but I would need to add some debug messages to be sure. I would need to get the source for Unscramble. GitHub only seems to have v1.0 (I think).
Also, I thought I read that you lost the v3.0 code, and someone (XeonG8?) made a v4.0 (from v2.0?).
Any direction would be appreciated. Thanks!
@xxxteslaxxx
I have it narrowed down to only '$' prizes not being awarded with '/us claim'. When I try cobblestone (id:4) it works. Of course, I have vault (required for unscramble) with Essentials (economy).
Hotshot2162,
Now that I think I fixed the permissions with Unscramble, I still can't get the prize automatically awarded to the winner. I am running on Minecraft 1.6.2. This is the same result whether I run the Unscramble command myself or through AutoUnscramble.
Before I set up the permissions properly, it used to mention '/us claim' to the winner. When attempted, it didn't work because of user permissions. Now that I've fixed the permissions, the '/us claim' message does not show up. The prize is not awarded, even though there was a winner. When the winner types '/us claim' it says that there are no prizes under his/her name.
I also have Essentials and GroupManager installed on my server.
Any ideas?
I just uploaded my code by filing a ticket.
I also think I resolved my issue by adding the current game time to the next iterations delay.
There is a readme.txt in there too.
@xxxteslaxxx
You may open a ticket and upload any files there. I look forward to seeing your code :)
I appreciate the encouragement and interest.
I have completed everything I stated previously and tested it out some. It's not much, but it took me a while to figure it out. I'm very new to java and minecraft plugin development. It was even the first time I've ever used something other than just a text editor (eclipse). I tried to learn from the forums and wikis.
There is one issue I can't figure out how to resolve. I'd like the timer for the next iteration to start after Unscramble completes the current game. Unfortunately, I don't know how to do this (especially as a separate plugin), so the timer starts immediately after Unscramble starts a game. This means you have to have an iteration delay larger than any possible Unscramble game. No big deal, but it would be more robust if it could handle that case.
I'm sure there are other issues / improvements that could be made to my code.
I've included my ".jar" file, which includes my source and ".yml" files, and a small top-level word list. The word list includes two others and some other words. The word lists should be placed in the same directory / folder as the ".jar" file. The word lists provided were just used as a proof of concept.
I have everything in ".tar.gz", but I don't know how to upload it. It's very small.
Had this bookmarked for a year, been checking back ever since the last update.
Glad to see others are contributing to the project.
@xxxteslaxxx
I absolutely LOVE this idea. I keep all my plugins in Public Domain, so any edits/additions are totally welcome.
If you release this plugin on bukkit, I would surely place a link to it on this thread, and suggest it to any who ask.
Also, as you suggested, I would love to create a merger of the two further down the road.
Hotshot2162,
I am new to Minecraft plugins and java (though have programmed in C,C\+\+, and PERL). My kids love "unscramble" (v3.0), which we're running on a small home server (Minecraft v1.6.2). They want to have it automated (and I was interested in plugin development), so I started creating a plugin, which would invoke "unscramble" automatically. I plan to have the following features ...
1. Read word lists (with categories): I've already got this working. It uses recursion to read in words from multiple word lists. It starts with "words.txt", which may have multiple "#include <path>/words_<category>.txt" lines or just words (no category). It places each word and its category in a LinkedList. All of this is done during "onEnable()".
2. Automatically call "unscramble" periodically (configurable: every half-hour as an example) with a randomly chosen word: I have the random part done, but I need to figure out the rest of this.
3. Only call "unscramble" when more than 1 player is on server: Not even started yet.
4. Add configuration: Not even started yet. How often to call "unscramble"? Different total (t:) and hint (h:) time durations, based on length of word. Different prizes for different word lengths. Others?
Anyway, I thought I'd let you know, since "unscramble" is the main reason for my plugin. Do I need your permission to continue? I'm new to Minecraft plugin development. Also, it might be more efficient if we merge the two into one plugin eventually.
My kids and their friends love "unscramble", and everyone they tell about it loves the idea of it. Thanks for creating a fun plugin for Minecraft.
@XeonG8
Also, you said you made enhancements? Could you make a list of what you added/changed?
@XeonG8
Thank you, Ill take a look and get back to you.