By: SErebros Since: September 2019 Licence: MIT
Welcome to Dukemon , the Flashcard app of the future!
Dukemon aims to streamline and gamify the process of learning words or definitions through the use of self-created digital flashcards. Supercharge your learning with Dukemon!
-
Ensure you have Java
11or above installed on your system. -
Download the latest
Dukemon.jarhere. -
Copy the file to the folder you want to use as the home directory of Dukemon (this is where your data will be stored).
-
Double-click the
Dukemon.jarto run the app. -
Before getting to the quick start instructions, get familiar with our interface and appication modes.
-
Click on the CommandBox as shown above (region in yellow box) and type commands in.
-
Use Enter to execute commands.
-
e.g. Typing
helpinto the CommandBox and pressing Enter will open the Help window.
-
-
Text-based feedback for each command entered is shown in the ResultDisplay (region in red box).
There are 4 application modes.
In the highlighed section above, you can see the current mode you are in and the available modes.
To transition between them you have to enter the SwitchCommand that represents each mode into the Command Box that says Enter command here...
-
openEnter
to enteropenmode -
startEnter
to entergamemode -
settingsEnter
to entersettingsmode -
homeEnter
to enterhomemode
Requirements before changing mode
-
A bank should be selected
-
No game should be running
Yes, it feels like a steep learning curve >_<
But do not worry as we have the AutoComplete Bar that auto completes the available commands whichever mode you are in.
The highlighted section shows, what commands are currently available. You can click them to automatically fill it in for you. Each of your keystroke will dynamically update the AutoComplete bar, just like the keyboard on your smartphone.
To enable sharing of word banks between friends, You can drag and drop a particular word bank out of the app into your computer. Likewise, you can drag and drop a json word bank into your app.
Try it!
|
ℹ️
|
The drag and drop feature works fine on Windows, but exporting through drag and drop may sometimes crash the app
on Mac. To avoid this on Mac, simply use the export command instead. |
Lets select the sample WordBank and play a game to get familiar.
-
select sampleEnter-
This would allow you to switch modes
-
-
openEnter -
startEnter -
guess <your_guess>Enter-
keep guessing till the statistics screen appears
-
you can switch modes now
-
-
homeEnter
Getting comfortable? Ready to master the application commands?
Some typical commands to get familiar with are:
-
create <NAME>: Create an empty WordBank with specified name. -
select <NAME>: Select and switch to WordBank with the specified name. -
add w/<WORD> m/<MEANING>: Adds a new Card with specified Word and Meaning into the current WordBank. -
list: List all Cards in the current WordBank. -
start <EASY/MEDIUM/HARD>: Starts a Game session with the specified Difficulty. Default difficulty in Settings will be used if not specified. -
guess <YOUR_ANSWER>: Make a Guess for the current Word whose Meaning is shown on the UI. -
stop: Stops the current Game session. -
exit: Exit Dukemon.
-
Create/Choose a Wordbank
-
View Global Statistics
-
Create/Add/Modify Cards of your WordBank. (Each Card contains a Word and Meaning).
-
View Statistics belonging to a specific WordBank
-
Guess Words based on each Meaning that appear as quickly as possible!
-
Finish the Game and view the Statistics for your game session.
-
Evaluate your performance
-
Configure your preferred Settings. (change Difficulty, Theme etc.)
Command Format
-
Words in
UPPER_CASEare the parameters to be supplied by the user.
Eg. inadd w/WORD m/MEANING,WORDis a parameter which can be used as
add w/Charmander m/Fire starter pokemon. -
Items in square brackets are optional.
Eg.w/WORD [t/TAG]can be used as
add w/Squirtle m/Water starter pokemon t/Water typeor as
add w/Squirtle m/Water starter pokemon. -
Items with
… after them can be used multiple times including zero times.
E.g.[t/TAG]…can be used ast/CS2040,t/CS2040 t/GRAPHetc. -
Parameters can be in any order.
E.g. if the command specifiesw/WORD m/MEANING,m/MEANING w/WORDis also acceptable.
(Available in all modes as long as WordBank is selected and game is not running)
Opens the page to edit the WordBank selected.
Format: open
-
Use the select command to select a WordBank. Otherwise it won’t work.
Start the game with the WordBank selected.
Format: start [DIFFICULTY]
-
Use the select command to select a WordBank. Otherwise it won’t work.
Examples:
-
start -
start easy
|
ℹ️
|
Entering the start command after wordbank is selected will enter game mode. In event that there are fewer than 3 flash cards, the game would not run. You would have to go to open mode to add flash cards.
|
(Available in Home mode)
Let Dukemon know what WordBank you have selected.
Format: select WORD_BANK
Examples:
-
select arithmetic -
select sample
Creates a new WordBank with specified name.
Format: create WORD_BANK
Examples:
-
create CS2040 -
create Biology
Removes a new WordBank with specified name.
Format: remove WORD_BANK
Examples:
-
Remove Gen 3 pokemon -
Remove Vocabulary
Import the WordBank from a specified folder path on your system.
Format: import w/WORD_BANK f/FOLDER
-
FOLDER is the folder where the WordBank file reside.
-
WORDBANK is the name of the file without the extension.
-
Dukemon can only read json WordBank files.
Examples:
(Use \ for Windows)
-
import w/cs2040_graph f/~/downloads -
import w/fire pokemons f//Users/chrischenhui/data
|
ℹ️
|
We have a drag and drop feature. You can drag and drop a file from your computer into the section which holds the _WordBank_s. |
Export the WordBank to a specified file path on your system.
Format: export w/WORD_BANK f/FOLDER
-
FOLDER is the folder where the WordBank file reside.
-
WORDBANK is the name of the file without the extension.
-
Dukemon exports WordBanks into json files.
Examples:
-
export w/ma1101r theorems f/~ -
export w/biology definitions f/~/downloads
|
ℹ️
|
We have a drag and drop feature. You can also drag and drop a WordBank out the app into your computer. |
(Available in Open mode)
Adds a new word-meaning pair to the WordBank.
Format: add w/WORD m/MEANING
Examples:
-
add w/Dukemon m/the Flashcard app of the future -
add w/Newton’s third law of motion m/Every action will produce and equal and opposite reaction -
add w/Kopi Luwak m/Coffee produced from the coffee beans found in the faeces of a civet cat
|
ℹ️
|
There can be duplicate words, but duplicate meanings will be rejected. |
Deletes the specified index from the WordBank.
Format: delete INDEX
-
Deletes the word at the specified
INDEX. -
The index must be a positive integer 1, 2, 3, …, and must be a valid index within the list.
-
The index refers to the index number shown in the displayed card list.
Examples:
-
delete 2
Deletes the 2nd word. -
delete 1
Deletes the 1st word in the results of thefindcommand.
Edits a card.
Format: edit INDEX [w/WORD] [m/MEANING] [t/TAG]
Examples:
-
edit 1 w/new word m/new meaning -
edit 2 m/new meaning with tag t/tagged
Finds entry whose word or meaning or tag contain any of the given keywords.
Format: find KEYWORD [MORE_KEYWORDS]…
-
The search is case insensitive. e.g
hanswill matchHans -
The order of the keywords does not matter. e.g.
Hans Bowill matchBo Hans -
Word, meaning and tag will be searched
-
Words contained within will be matched e.g.
formalwill matchInformal -
Cards matching at least one keyword will be returned (i.e.
ORsearch). e.g.Hans Bowill returnHans Gruber,Bo Yang
Examples:
-
find long
Returns any entries containinglongin its word or meaning or tag. -
find mammal fish bird
Returns any entries containingmammal,fishorbirdin its word or meaning or tag.
(Available in Game mode)
This section covers the actions and feedback that are relevant to the Game mode. The general layout of the UI when a Game is in progress is as seen above.
-
The timer will be activated to reflect the time left before the Game skips over to the next card. (region in yellow box)
-
The Meaning of the current Card is shown in the region contained by the red box. Based on this Meaning you will make a Guess for the Word it is describing.
-
Hints (if enabled) will be periodically shown as time passes (region in the blue box) in a Hangman-style. The number of hints given differs across each Difficulty.
The relevant command(s) are:
-
Starting new game session:
Format:
start [EASY/MEDIUM/HARD]-
Starts a game session with the currently selected WordBank and specified Difficulty. (WorkBank selection is done in Home mode.)
-
If no Difficuty is specfied, the default Difficulty in Settings will be used.
-
During a Game, the Timer will change colour according to the time left (region in green box). Feedback for each Guess is shown via the ResultDisplay (region in the red box).
The relevant command(s) are:
-
Making a Guess for a Word:
Format:
guess WORD-
Makes a guess for the Word described by the currently shown Meaning. (non case-sensitive)
-
-
Skipping over a Word:
Format:
skip-
Skips over the current Word. (is counted as a wrong answer)
-
A Game finishes when all Cards have been attempted. Statistics are
automatically shown upon completion of a Game (see Fig. 6 above).
The user can choose to stop a Game before it has finished. This will result in all current Game progress being lost, and
no Statistics being collected or generated (see Fig. 7 above).
The relevant command(s) are:
-
Stopping a Game (before it has finished):
Format:
stop-
Forcibly terminates the current active Game session (all progress will be lost, and no Statistics will be reported.)
-
(Available in Settings mode)
Goes into the settings menu.
Format: settings
Changes the theme of the UI.
Format: theme dark/light
Examples:
-
theme dark
Changes the UI theme to dark.
-
theme light
Changes the UI theme to light.
Turns hints on or off.
Format: hints on/off
Examples:
-
hints on
Turns hints on.
-
hints off
Turns hints off.
Changes the difficulty of the game.
Format: difficulty easy/medium/hard
Examples:
-
difficulty easy
Changes the difficulty to easy. (Timer = 15 seconds)
-
difficulty medium
Changes the difficulty to medium. (Timer = 10 seconds)
-
difficulty hard
Changes the difficulty to hard. (Timer = 5 seconds)
Changes the avatar in the home screen. The avatar is one of the 151 original pokemon, so pick and choose! (There is a secret avatar as well. See if you can find it!)
Format: avatar [0 - 151]
avatar 0 sets the avatars to random.
Examples:
-
avatar 0
Changes the avatar to a random one everytime a new command is called.
-
avatar 1
Changes the avatar to 001 in the original Pokedex, which is Bulbasaur.
-
avatar 151
Changes the avatar to 151 in the original Pokedex, which is Mew.
This section covers the statistics shown to the user.
The game result is shown to the user every time they finish a game. It contains information of the finished game and some information of the WordBank.
We use a simple formula to calculate the score: floor of (Number of correct answers) / (Total questions) * 100.
The WordBank statistics is shown on open mode and contains all information of the WordBank.
Q: How do I pronounce your app name?
A: Think Pokemon.
Q: How do I transfer my WordBank to my friend?
A: Export your WordBank to your computer, then transfer him the file. He can then import the file into his Dukemon.
Q: Do I have to save data?
A: Dukemon data are saved in the hard disk automatically after any command that changes the data.
These commands are generally card commands.
There is no need to save manually.
Statistics are also stored automatically.
| Command Type | Command Keyword | Parameter(s) (if any) |
|---|---|---|
Switch Commands |
|
|
|
||
|
|
|
|
||
WordBank Commands |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Card Commands |
|
|
|
|
|
|
|
|
|
|
|
|
||
|
||
Game Commands |
|
|
|
||
|
||
Settings Commands |
|
|
|
|
|
|
|
|
|
|
|
Misc. Commands |
|
|
|
||
Smart algorithms to pop reminders for you to know which bank you have not visited and is most likely to forget soon.
Have more than one account to monitor statistics on the same computer