Mode60 Official Website

https://patreon.com/mode60		Thank you for your support!
NAVIGATION	INFORMATION FEED	CURRENT PROJECT INFO
PYTHON zCore Source Code Help and Configuration Plugin Creation Guide (coming soon) System Module Guide (coing soon) zCore Plugins Trivia Master Super DuckHunt v2.0 RPGenerator Super DuckHunt Bot v1.1.4 Source Code (v1.1.4) GNU License User Help Page Operator's Guide AUTOIT RPGenerator RPGenerator Concept (Ended) RPGenerator (User Client) Super DuckHunt (WinDuck) Source Code (Discontinued) mIRC Duck Hunter Script Super Duck Hunter Script RPGenerator (User Script) Programming Resources Python.org AutoitScript.org mIRC.com Scintilla.org PyCharm by JetBrains Dev Resources Aseprite Kdenlive OBS Studio GIMP Reaper	-------------------------------------------------------------------------- Plugin Module Version 1.9.9 BETA -------------------------------------------------------------------------- Super DuckHunt version 1.9.9 BETA is here. A port of the stand alone bot (version 1.1.4) made as a plugin for zCore. This is the prototype for version 2.0.0! Faster, bigger, better and capable of running on multiple networks and channels all from one zCore process. Some new features and additions also come with this new version. (See the Super DuckHunt help page for version changes!) More on that below. This has been an experimental project to help develop zCore and its functions. Super DuckHunt v1.9.9 can now be beta tested and run off your zCore with stability and reliability. Source code and information links at the bottom of this article. I would also like to take a moment give thanks to everyone involved. I am happy to announce that MenzAgitat found this version of DuckHunt and has graciously offered me advice and ideas for the future of Super DuckHunt. I am very grateful and feeling star-struck that MenzAgitat, the original IRC DuckHunt creator, found my project and has offered me great DuckHunt knowledge, right from the big guy himself! I would also like to specifically thank ScifiSpirit who has voluntarily involved himself with helping me test Super DuckHunt and offering me ideas and advice, also another thanks to End3r who was the initial person who introduced me to MenzAgitat's version of DuckHunt and said to me "I wish someone would make a DuckHunt in python." the quote that inspired me to start developing Super DuckHunt. End3r has also graciously given me server space with free roam to do as I please in development of Mode60 projects. Thanks a ton, bud! I am also grateful to have so many people interested in this game, and to have regular players who play every day! WHAT'S NEW IN v1.9.9? Player fatigue - Players will gain fatigue the longer they play in short periods of time, affecting their accuracy and eventually leading to players collapsing from exhuastion. New shop item (26) is Coffee, which helps prevent exhaustion and reduces a player's fatigue. Fatigue also decreases when players become idle for more than 1 hour. Camping Permits and Penalties - If a player decides to 'camp out' and shoot all the ducks that pop up, they will be penalized with a 2 hour penalty where they will be unable to hunt or feed ducks. Players will have to buy expensive camping permits from the shop (item 25) to gain an 8 hour window of unlimited hunting and feeding. Without a permit a player can incur an 'Illegal Camping Penalty' in the game which will disable their feeding and hunting abilities for 2 hours. Whenver a player becomes idle for more than 2 hours their camp count will return to 0. Reaction times for feeding ducks - Similar to the reaction times for hunting ducks, a reaction time for feeding ducks will now be displayed in the confirmation message whenver a player successfully befriends a duck. Variable Golden Duck xp - Now every golden duck will give a player a varied amount of xp. The total amount of xp won is determined by how difficult the golden duck is. The more difficult it is the more xp a player can earn from a successful shot or befriending. Up to 15 times the regular duck xp. Improved !duckstats - !duckstats now has an improved display which also includes fatigue and camp counts, and new easier to read message layout. 2 new shop items - Two new items will be found in the shop. Item 25, Camping Permit, to allow 8 hours of protection against Illegal Camping penalties and Item 26 Coffee which reduces player fatigue by up to 50% and allows a player to continue hunting or feeding ducks if they have collapsed from exhaustion. Remodeled total statistics program - The old !tshot system has been replaced with the !totals system, which shows daily, weekly and monthly statistics of all ducks that have been successfully shot or befriended. WHAT'S COMING NEXT FOR SUPER DUCKHUNT v2.0.0? With the completion of the v1.1.4 port, v1.9.9 can now run in multiple places at once, all from your zCore installation. Now that v1.9.9 is up and running, what will come next? Well first, while this is out and moving, I'm going to take a break from major development of Super DuckHunt to work on other Mode60 projects. I will still maintain and commit bug fixes during the duration of v1.9.9 beta testing, but the next big step for Super DuckHunt v.2.0.0 release is currently a while away. That aside, here are some things to look forward to in v2.0.0: Full i18n support - v2.0.0 will be released with full i18n support for ease of translation and customization. SQL database support - This will allow for stats from the game to be uploaded and shared on a web page. Variable spawn timers - Instead of the set spawn and fly times, v2.0.0 will allow hosts to set a variable time limit to make duck spawns unpredictable. Year round and time based events - Hosts running v2.0.0 will have access to enable special in-game events based around holidays or weekly time frames. Hosts will also be able to set routine resets based on time, if desired. New shop items - In addition to the two new shop items in v1.9.9, v2.0.0 will include more new shop items to increase game interaction and challenge. v1.9.9 SOURCE CODE \| HELP PAGE \| v1.9.9 INSTALLATION GUIDE (COMING SOON) \| v1.9.9 OPERATOR'S GUIDE (COMING SOON) °²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³° ><))°> SPLASH -------------------------------------------------------------------------- Plugin Module Test User Guide -------------------------------------------------------------------------- This article is currently the Trivia-Master user test guide To go along with zCore alpha-testing release, is Trivia-Master, one of the first zCore plugin modules using zCore's scriptable plugin system. This plugin module is in ultra beta status, meaning it is not 100% finished but is currently an 'operationally stable' script. The features or gameplay in this Trivia-Master module may not resemble the features and abilities of the official public release. Trivia-Master is a run of the mill IRC trivia game that allows bot hosts to customize the category and question selection. Only game mode available currently is random trivia. Random trivia picks a random category and selects a random question from that category. (Future game modes like Category 123 in the works.) Using !myscore will detail your player stats. User Commands (Botmaster commands scroll down) In channel commands: !myscore - Shows your score in channel !thelp - Currently lists these commands. !highscore - Show the 5 highest scores !streaks - Show the best winning streaks Installation Requires: Python 3.12 First install the Trivia-Master files into the zcore folder/directory. Click here for more information on installing, mounting and using zCore plugin modules. After installation proceed with the Trivia-Master configuration described below: Configuration Open ./zcore/trivia.cnf with a text editor [trivia] serverlist = servername1 Must match a server name listed in zcore.cnf serverlist (lowercase only) categories = acronym-soup,anatomy,animals,art-and-literature,etc Do not change at this time [servername1] channels = #triviachannelname Must match a channel name listed in the server data in zcore.cnf (lowercase only) [servername1_triviachannelname] Must match the server and channel listed above, without the # (lowercase only) cache = 0 Click here to view zcore config examples! After configuration is complete go to your IRC terminal on the server where zCore is connected In the IRC terminal type in this command: /privmsg botname mount-p trivia Botmaster Commands In channel commands: !trivia on - turn on the game !trivia off - turn off the game !trivia skip - skip current question /privmsg commands: /privmsg botname rem-q category-name /privmsg botname add-q category-name ^Question text goes here`Answer text here /privmsg botname clean category-name /privmsg botname clean all °²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³° ><))°> SPLASH -------------------------------------------------------------------------- Scriptable and Modular Python IRC Bot Platform -------------------------------------------------------------------------- Click here to visit the zCore v0.1x User's Guide zCore is a free and open source software, written in Python and can run on any Windows, Linux (or macOS) operating system with Python 3.12.0 installed. Out of the box zCore can connect to single or multiple IRC networks and channels that you specify in the configuration, and runs the zCore System Module that has basic IRC features and importable scripting functions for plugins. zCore uses a multi-threaded and asyncronous processing structure that allows for multiple connections and features to run simultaneously. The core software alone does everything needed for IRC connection. If no system module or plugin(s) are used, zCore will connect, and stay connected to IRC networks, join channels, and idle. With the pre-installed zCore System Module, there are some basic built in channel operation commands (simple stuff like !op, !kick etc). The zCore System Module also features an access priviledge system that can also be used in scripting plugins. The access system consists of 3 levels of access to the zCore system administration functions, Global Botmasters (Full access), Local Admins (Limited access), and Voice users (+v). There is also a auto kick/ban list. Any botmaster or admin listed receive +o (channel operator) when joining their accessed channels, and voice users receive +v on the channel. zCore features a scriptable plugin system that can load and run custom designed Python modules. zCore accepts two forms of python modules, one is called the system module and the other is a plugin module. The system module is a single universal supplement to the main core but can also be imported into plugin modules for scripting. These system modules handle the global attributes for all connection threads, such as userlist updating or administration access functions. The plugin modules are desgined to trigger on specified IRC events, such as JOIN, PART, PRIVMSG etc as a normal IRC bot/client would. The scriptable system will have documentation on how users can make their own plugin modules. Plugin modules are where users can really get creative. Along with some available plugins, users can also make their own plugins. The core software is capable of running one system module and multiple zCore plugins simultaneously, and can be configured to run certain plugins on certain channels, or all channels etc. Thru this scriptable and modular system you could run multiple IRC channel and network bots all on one platform effeciently, or host the same bot in multiple places without having to run extra shell processes. Also there will be a tutorial and coding guide for users who want to learn how to make plugins for this software.	Version: 0.1x Author: Mode60/Neo Nemesis Alpha Testing Source Code \| User Guide FEATURED MODULE FOR TESTING Version: 1.00 Ultra Beta Developer: Mode60 Beta Testing Source Code \| User Guide

--------------------------------------------------------------------------
Plugin Module
Version 1.9.9 BETA
--------------------------------------------------------------------------

Super DuckHunt version 1.9.9 BETA is here. A port of the stand alone bot (version 1.1.4) made as a plugin for zCore. This is the prototype for version 2.0.0! Faster, bigger, better and capable of running on multiple networks and channels all from one zCore process. Some new features and additions also come with this new version. (See the Super DuckHunt help page for version changes!) More on that below. This has been an experimental project to help develop zCore and its functions. Super DuckHunt v1.9.9 can now be beta tested and run off your zCore with stability and reliability. Source code and information links at the bottom of this article.

I would also like to take a moment give thanks to everyone involved. I am happy to announce that MenzAgitat found this version of DuckHunt and has graciously offered me advice and ideas for the future of Super DuckHunt. I am very grateful and feeling star-struck that MenzAgitat, the original IRC DuckHunt creator, found my project and has offered me great DuckHunt knowledge, right from the big guy himself! I would also like to specifically thank ScifiSpirit who has voluntarily involved himself with helping me test Super DuckHunt and offering me ideas and advice, also another thanks to End3r who was the initial person who introduced me to MenzAgitat's version of DuckHunt and said to me "I wish someone would make a DuckHunt in python." the quote that inspired me to start developing Super DuckHunt. End3r has also graciously given me server space with free roam to do as I please in development of Mode60 projects. Thanks a ton, bud! I am also grateful to have so many people interested in this game, and to have regular players who play every day!

WHAT'S NEW IN v1.9.9?

Player fatigue - Players will gain fatigue the longer they play in short periods of time, affecting their accuracy and eventually leading to players collapsing from exhuastion. New shop item (26) is Coffee, which helps prevent exhaustion and reduces a player's fatigue. Fatigue also decreases when players become idle for more than 1 hour.

Camping Permits and Penalties - If a player decides to 'camp out' and shoot all the ducks that pop up, they will be penalized with a 2 hour penalty where they will be unable to hunt or feed ducks. Players will have to buy expensive camping permits from the shop (item 25) to gain an 8 hour window of unlimited hunting and feeding. Without a permit a player can incur an 'Illegal Camping Penalty' in the game which will disable their feeding and hunting abilities for 2 hours. Whenver a player becomes idle for more than 2 hours their camp count will return to 0.

Reaction times for feeding ducks - Similar to the reaction times for hunting ducks, a reaction time for feeding ducks will now be displayed in the confirmation message whenver a player successfully befriends a duck.

Variable Golden Duck xp - Now every golden duck will give a player a varied amount of xp. The total amount of xp won is determined by how difficult the golden duck is. The more difficult it is the more xp a player can earn from a successful shot or befriending. Up to 15 times the regular duck xp.

Improved !duckstats - !duckstats now has an improved display which also includes fatigue and camp counts, and new easier to read message layout.

2 new shop items - Two new items will be found in the shop. Item 25, Camping Permit, to allow 8 hours of protection against Illegal Camping penalties and Item 26 Coffee which reduces player fatigue by up to 50% and allows a player to continue hunting or feeding ducks if they have collapsed from exhaustion.

Remodeled total statistics program - The old !tshot system has been replaced with the !totals system, which shows daily, weekly and monthly statistics of all ducks that have been successfully shot or befriended.

WHAT'S COMING NEXT FOR SUPER DUCKHUNT v2.0.0?

With the completion of the v1.1.4 port, v1.9.9 can now run in multiple places at once, all from your zCore installation. Now that v1.9.9 is up and running, what will come next? Well first, while this is out and moving, I'm going to take a break from major development of Super DuckHunt to work on other Mode60 projects. I will still maintain and commit bug fixes during the duration of v1.9.9 beta testing, but the next big step for Super DuckHunt v.2.0.0 release is currently a while away. That aside, here are some things to look forward to in v2.0.0:

Full i18n support - v2.0.0 will be released with full i18n support for ease of translation and customization.

SQL database support - This will allow for stats from the game to be uploaded and shared on a web page.

Variable spawn timers - Instead of the set spawn and fly times, v2.0.0 will allow hosts to set a variable time limit to make duck spawns unpredictable.

Year round and time based events - Hosts running v2.0.0 will have access to enable special in-game events based around holidays or weekly time frames. Hosts will also be able to set routine resets based on time, if desired.

New shop items - In addition to the two new shop items in v1.9.9, v2.0.0 will include more new shop items to increase game interaction and challenge.

v1.9.9 SOURCE CODE | HELP PAGE | v1.9.9 INSTALLATION GUIDE (COMING SOON) | v1.9.9 OPERATOR'S GUIDE (COMING SOON)

°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³° ><))°> *SPLASH*

--------------------------------------------------------------------------
Plugin Module
Test User Guide
--------------------------------------------------------------------------

This article is currently the Trivia-Master user test guide

To go along with zCore alpha-testing release, is Trivia-Master, one of the first zCore plugin modules using zCore's scriptable plugin system. This plugin module is in ultra beta status, meaning it is not 100% finished but is currently an 'operationally stable' script. The features or gameplay in this Trivia-Master module may not resemble the features and abilities of the official public release.

Trivia-Master is a run of the mill IRC trivia game that allows bot hosts to customize the category and question selection. Only game mode available currently is random trivia. Random trivia picks a random category and selects a random question from that category. (Future game modes like Category 123 in the works.) Using !myscore will detail your player stats.

User Commands (Botmaster commands scroll down)

!myscore - Shows your score in channel
!thelp - Currently lists these commands.
!highscore - Show the 5 highest scores
!streaks - Show the best winning streaks

Installation

Requires: Python 3.12

First install the Trivia-Master files into the zcore folder/directory. Click here for more information on installing, mounting and using zCore plugin modules. After installation proceed with the Trivia-Master configuration described below:

Configuration

Open ./zcore/trivia.cnf with a text editor

[trivia]
serverlist = servername1 Must match a server name listed in zcore.cnf serverlist (lowercase only)
categories = acronym-soup,anatomy,animals,art-and-literature,etc Do not change at this time

[servername1]
channels = #triviachannelname Must match a channel name listed in the server data in zcore.cnf (lowercase only)

[servername1_triviachannelname] Must match the server and channel listed above, without the # (lowercase only)
cache = 0

Click here to view zcore config examples!

After configuration is complete go to your IRC terminal on the server where zCore is connected

In the IRC terminal type in this command:
/privmsg botname mount-p trivia

Botmaster Commands

!trivia on - turn on the game
!trivia off - turn off the game
!trivia skip - skip current question

/privmsg botname rem-q category-name
/privmsg botname add-q category-name ^Question text goes here`Answer text here
/privmsg botname clean category-name
/privmsg botname clean all

°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³°°²·»¸_¸«·³° ><))°> *SPLASH*

--------------------------------------------------------------------------
Scriptable and Modular Python IRC Bot Platform
--------------------------------------------------------------------------

Click here to visit the zCore v0.1x User's Guide

zCore is a free and open source software, written in Python and can run on any Windows, Linux (or macOS) operating system with Python 3.12.0 installed. Out of the box zCore can connect to single or multiple IRC networks and channels that you specify in the configuration, and runs the zCore System Module that has basic IRC features and importable scripting functions for plugins.

zCore uses a multi-threaded and asyncronous processing structure that allows for multiple connections and features to run simultaneously. The core software alone does everything needed for IRC connection. If no system module or plugin(s) are used, zCore will connect, and stay connected to IRC networks, join channels, and idle. With the pre-installed zCore System Module, there are some basic built in channel operation commands (simple stuff like !op, !kick etc). The zCore System Module also features an access priviledge system that can also be used in scripting plugins.

The access system consists of 3 levels of access to the zCore system administration functions, Global Botmasters (Full access), Local Admins (Limited access), and Voice users (+v). There is also a auto kick/ban list. Any botmaster or admin listed receive +o (channel operator) when joining their accessed channels, and voice users receive +v on the channel.

zCore features a scriptable plugin system that can load and run custom designed Python modules. zCore accepts two forms of python modules, one is called the system module and the other is a plugin module. The system module is a single universal supplement to the main core but can also be imported into plugin modules for scripting. These system modules handle the global attributes for all connection threads, such as userlist updating or administration access functions. The plugin modules are desgined to trigger on specified IRC events, such as JOIN, PART, PRIVMSG etc as a normal IRC bot/client would. The scriptable system will have documentation on how users can make their own plugin modules.

Plugin modules are where users can really get creative. Along with some available plugins, users can also make their own plugins. The core software is capable of running one system module and multiple zCore plugins simultaneously, and can be configured to run certain plugins on certain channels, or all channels etc. Thru this scriptable and modular system you could run multiple IRC channel and network bots all on one platform effeciently, or host the same bot in multiple places without having to run extra shell processes. Also there will be a tutorial and coding guide for users who want to learn how to make plugins for this software.