TODO.wiki
author Wuzzy
Wed, 21 Jun 2023 12:50:32 +0000
changeset 2242 031a5b86e533
parent 2179 838ab168a110
child 2253 1bd9936f6b01
permissions -rw-r--r--
LuaLibraryAnimate: Say what happens after animation ends
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
196
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
     1
#summary Where to find possible task, todos, fixmes and new ideas.
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
     2
#labels Featured,Phase-Requirements,Phase-Design,Phase-Implementation,Phase-QA,Phase-Support
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
     3
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
     4
= To-do list =
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
     5
304
e0da7bf566b6 toc and escape
vittorio.giovara@gmail.com
parents: 303
diff changeset
     6
<wiki:toc max_depth="2" />
e0da7bf566b6 toc and escape
vittorio.giovara@gmail.com
parents: 303
diff changeset
     7
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
     8
== Introduction ==
196
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
     9
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
    10
Welcome! If you are reading this page you might be wondering how you can help the Hedgewars project! Fear no more, we've set up a good list of ideas that you might tackle while getting to know the sources!
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
    11
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
    12
As always, we'll be glad to help you in this quest! Just join our IRC channel and ask the devs directly! The possible ideas are divided by category and some might be easier than others: just pick the one you feel most confident with.
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
    13
2177
d2cb5fae6085 TODO: fix typo
Wuzzy
parents: 2176
diff changeset
    14
== Easy hacks ==
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    15
305
b85a981d439f typo and escapes
vittorio.giovara@gmail.com
parents: 304
diff changeset
    16
Just want to get your hands dirty? Pick one of your choice!
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    17
305
b85a981d439f typo and escapes
vittorio.giovara@gmail.com
parents: 304
diff changeset
    18
  * Perform some code cleanup, engine and frontend really need some! `Grep` for TODO and FIXME and you'll find plenty of examples. File loading, image flag handling and various little improvements just wait for you.
1424
4a31af381463 TODO: fix formatting
Wuzzy
parents: 1091
diff changeset
    19
  * Make our AI use any weapon of your choice. Check out the `uAI*.pas` files and see how the current weapons are handled.
305
b85a981d439f typo and escapes
vittorio.giovara@gmail.com
parents: 304
diff changeset
    20
  * Write a simple shell script (`bash`, `ruby`, `perl`, `python`, `awk`...) to update the localization strings for iOS and propagate the diff to all the localized files. This task doesn't require coding or having an i-Device, just basic shell scripting.
b85a981d439f typo and escapes
vittorio.giovara@gmail.com
parents: 304
diff changeset
    21
  * Make a cross-platform tool (for instance a script) that identifies new phrases in our mission, training and gameplay scripts and adds them (marked untranslated) into our `Lua` localization files.
b85a981d439f typo and escapes
vittorio.giovara@gmail.com
parents: 304
diff changeset
    22
  * Run `Valgrind` on engine, report the  most used functions and optimize them so that performance increases.
b85a981d439f typo and escapes
vittorio.giovara@gmail.com
parents: 304
diff changeset
    23
  * Use the Qt macro `QtPrintable` everywhere instead of looping through various string methods.
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    24
  * Document compiler flags: just add a little comment near each flag explaining its use.
306
2f13f8031eaa one more todo
vittorio.giovara@gmail.com
parents: 305
diff changeset
    25
  * Add a little weapon description in the configuration page, through the `setWhatsThis()` method.
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    26
  * Document video flags, in video recording section.
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    27
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    28
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
    29
== Code ==
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    30
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    31
For those not afraid of the dark, dive in and tackle a complex project!
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    32
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
    33
=== AI ===
640
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    34
 * Teach the AI how to use:
1064
15c50445ad26 TODO: Edited via web interface
Wuzzy
parents: 1063
diff changeset
    35
  * Most important things
1063
6942219a65ba TODO: Edited via web interface
Wuzzy
parents: 1062
diff changeset
    36
   * Hellish handgrenade
6942219a65ba TODO: Edited via web interface
Wuzzy
parents: 1062
diff changeset
    37
   * Napalm
640
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    38
  * Weapons
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    39
   * Ballgun
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    40
   * Birdy
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    41
   * Blowtorch
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    42
   * Flamethrower
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    43
   * Freezer
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    44
   * Pickhammer
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    45
  * Utilities
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    46
   * Structures
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    47
    * Girder
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    48
    * Rubber
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    49
    * Landspray
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    50
   * Movement
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    51
    * Flying saucer
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    52
    * Rope
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    53
    * Parachute
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    54
    * Portable portal device
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    55
    * Teleportation
e1b7cd26bb14 Update TODO list for AI weapons/utils
Wuzzy
parents: 639
diff changeset
    56
2145
517b819b4018 TODO: Add more TODO
Wuzzy
parents: 2086
diff changeset
    57
 * Better weapon implementation needed:
517b819b4018 TODO: Add more TODO
Wuzzy
parents: 2086
diff changeset
    58
  * Grenade-like weapons: Calculate bounces (currently, only direct shots without any bounces are supported)
517b819b4018 TODO: Add more TODO
Wuzzy
parents: 2086
diff changeset
    59
  * Mine, dynamite: Place on ground and run away (currently, only dropping from safe height is supported)
2153
6ab7b434d667 TODO: Update mine strike
Wuzzy
parents: 2152
diff changeset
    60
  * Mine Strike: Calculate bounces (currently, this weapon is not used if mines time is anything but 0, to avoid unpredictable behavior)
2154
b2103d0e8637 TODO: RC Plane
Wuzzy
parents: 2153
diff changeset
    61
  * RC Plane: Implement steering and dropping bombs (currently, can only fly in straight line)
2179
838ab168a110 TODO: Update sine gun
Wuzzy
parents: 2178
diff changeset
    62
  * Sine Gun: Check knockback
2158
f442a9a7de35 TODO: Update more AI todos
Wuzzy
parents: 2157
diff changeset
    63
  * Old Limburger: Throw slightly to the left or right of target, depending on wind. Avoid poisoning friends
2157
12af34640565 TODO: Add seduction
Wuzzy
parents: 2156
diff changeset
    64
  * Seduction: Implement more ways to fail, be more careful with shoving friends
2159
0a57d46f287a TODO: Update minigun, SMine is done
Wuzzy
parents: 2158
diff changeset
    65
  * Minigun: Simulate bullets, replace RateShotgun, move aim during shooting
2163
05481edb6b4a TODO: Low Grav
Wuzzy
parents: 2161
diff changeset
    66
  * Use low gravity and invulnerable to find more spots to walk to
2173
ad42ab030bd8 TODO: update resurrect
Wuzzy
parents: 2172
diff changeset
    67
  * Resurrector: Improve rating system
2145
517b819b4018 TODO: Add more TODO
Wuzzy
parents: 2086
diff changeset
    68
1065
ba3b02d187ae TODO: Update link
Wuzzy
parents: 1064
diff changeset
    69
See also: https://issues.hedgewars.org/show_bug.cgi?id=292
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    70
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    71
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
    72
=== Tools ===
915
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    73
  * Refactor the frontend networking layer into library calls from hwengine, in a similar fashion to what's done on iOS and Android, using Qt framebuffers
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    74
  * Create an easy-to-use theme editor, outlining all the necessary files for our themes
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    75
  * Implement an handicap system allowing for increased difficulty on some teams instead of on the whole match
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    76
  * If building server fails, try running the Cabal dependencies first
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    77
  * Allow themes to have more than one music file
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    78
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    79
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
    80
=== GUI improvements ===
915
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    81
  * Enable private messages in our lobby
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    82
  * Allow kicking with reason
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    83
  * Make the preferences that are modifiable from engine (eg. volume) update the ones specified in the frontend, using a new network message
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    84
  * Rework the draw-map functions, adding different brush sizes, brush types and something new
2086
0f8d2e38dec1 TODO: /quit was added
Wuzzy
parents: 1981
diff changeset
    85
  * Enable some commands while in frontend: for example `/leave` ( = `/part`  - for leaving room),, `/exit` (closes hedgewars), `/addFriend`, `/removeFriend`, `/ignore`, `/unignore`
915
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    86
  * Add checkboxes for selecting the best rendering mode in addition to the Quality slider
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    87
  * Lazy load previews, speed up frontend launch and compute previews only when necessary
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    88
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    89
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
    90
=== Graphics ===
915
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    91
  * Set up a wifi protocol so that tablets can draw maps and send it to the drawn maps of Hedgewars
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    92
  * Select the stereo renderer at runtime, either with a keybind or with a menu
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    93
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    94
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
    95
=== Engine ===
915
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    96
  * Allow participants in a game to view weapon sets and schemes before starting the game. This task could be carried out by showing an overlay window when mouse is over the scheme or weapon entries
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    97
  * Change the loading screen to show participating teams/players (and maybe even all the hogs if space is available
915
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
    98
  * Add the ability for themes to have stars high above the ground (comparable to clouds)
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
    99
  * Implement a better, faster land generation: for more details, visit http://accidentalnoise.sourceforge.net/minecraftworlds.html
904
7d19104d3317 TODO: Done: Rip out fort mode, play with gravity woo
Wuzzy
parents: 800
diff changeset
   100
  * Allow for flipped maps
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
   101
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
   102
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
   103
=== Mobile ===
915
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
   104
  * Implement preferences/options in the Android port, basically allow the existing preferences options from the desktop version to the port using Android shared preferences
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
   105
  * Better integrate CMake with the Android build, instead of using the autotools version
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
   106
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
   107
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
   108
== Documentation ==
196
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
   109
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
   110
=== Doxygen ===
196
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
   111
1068
72ba2233f61e TODO: Link to EngineTestCases
Wuzzy
parents: 1067
diff changeset
   112
  * Add Doxygen documentation to server for the Haskell sources
72ba2233f61e TODO: Link to EngineTestCases
Wuzzy
parents: 1067
diff changeset
   113
  * Add Doxygen documentation to ios frontend for the Objective-C sources
72ba2233f61e TODO: Link to EngineTestCases
Wuzzy
parents: 1067
diff changeset
   114
  * Add Doxygen documentation to engine for the Free Pascal sources
72ba2233f61e TODO: Link to EngineTestCases
Wuzzy
parents: 1067
diff changeset
   115
  * Add Doxygen documentation to android port for the Java sources
196
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
   116
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
   117
=== Various ===
196
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
   118
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
   119
  * Document the interaction of engine/frontend/server network protocol
915
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
   120
  * Document how the engine launches a game, from setting up the window, to updating the OpenGL renderer, from loading up contents, to cleaning up memory
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
   121
  * Document the format of the demo and save files
196
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
   122
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
   123
== Q/A ==
1068
72ba2233f61e TODO: Link to EngineTestCases
Wuzzy
parents: 1067
diff changeset
   124
=== Engine testing ===
72ba2233f61e TODO: Link to EngineTestCases
Wuzzy
parents: 1067
diff changeset
   125
Write Lua scripts to automatically test some engine features. See [EngineTestCases].
196
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
   126
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
   127
=== Testing framework ===
915
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
   128
  * Add an expandable testing module so that we can trigger main server functions and check their return values
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
   129
  * Add an expandable testing module so that we can trigger main frontend functions and check their return values
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
   130
  * Add an expandable testing module so that we can trigger main engine functions and check their return values
196
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
   131
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
   132
=== Other tests ===
641
0f32bfac1974 Some format fixes
Wuzzy
parents: 640
diff changeset
   133
915
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
   134
  * Unify the translation files in something more usable, reducing the number of files and the repeated phrases
196
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
   135
303
b281fa4ed31f Cleaned up, refreshed the TODO page
vittorio.giovara@gmail.com
parents: 251
diff changeset
   136
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
   137
== Translation ==
196
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
   138
1069
c428a18e2c76 TODO: Edited via web interface
Wuzzy
parents: 1068
diff changeset
   139
Pick a language of your choice! There is certainly need of an update or a revision or even a completely new language. Before each release, we generally announce a so-called “string freeze”, a period of times in which we promise not to update or change any English texts. This is the best period to translate, but you could translate earlier as well, but please keep in mind that your translations will become outdated then.
196
6f44db041544 Crafted a TODO list for future reference
vittorio.giovara@gmail.com
parents:
diff changeset
   140
1069
c428a18e2c76 TODO: Edited via web interface
Wuzzy
parents: 1068
diff changeset
   141
See [Translations] to learn more.
216
6f7c0c72bd12 revisited a few points
vittorio.giovara@gmail.com
parents: 215
diff changeset
   142
744
fb9cbe36ee52 TODO: Add title
Wuzzy
parents: 729
diff changeset
   143
== Contact ==
216
6f7c0c72bd12 revisited a few points
vittorio.giovara@gmail.com
parents: 215
diff changeset
   144
915
1cb6252cbcf4 Minor copy-editing of TODO list
Wuzzy <almikes@aol.com>
parents: 904
diff changeset
   145
The best way to get in touch with the devs is to join our IRC on Freenode (#hedgewars) and to interact with everyone there. Please be patient as not always there are discussions going on there.