News for hackers. Stuff that matters.
Re:Narbacular Drop Technical Design Document [pdf] by asdfasdf on Wednesday July 06, 2016 @05:26PM (#12045998)
Coding guidelines

- Precompute whenever even remotely possible.

- Measures must be taken to prevent copy paste errors.

- Measures must be taken to prevent copy paste errors.

- The STL is evil (most of the time).

- Unnecessarily virtual functions should be rewritten to remove virtual requirements.

- Sloppy code must be marked for recoding later.

- Unreadable code earns you a free punch in the face.

- Measures must be taken to prevent copy paste errors.

Re:Narbacular Drop Technical Design Document [pdf] by rbanffy on Thursday July 07, 2016 @03:00AM (#12047880)
"Checkouts can be performed at will (network permitting), but all code checked into the primary code branch MUST compile. Anyone caught checking-in uncompilable code will be tarred and feathered."
Re:Narbacular Drop Technical Design Document [pdf] by Bjartr on Wednesday July 06, 2016 @11:45AM (#12043816)
For those that aren't aware, the dev team for this was later hired by Valve and created Portal.
Re:Narbacular Drop Technical Design Document [pdf] by dpiers on Wednesday July 06, 2016 @02:41PM (#12045013)
Portal is a slightly dumbed down version of Narbacular Drop (ND), with lots and lots of polish. In ND, it was possible to create portals through portals, which drastically increased the complexity of certain solutions.
Re:Narbacular Drop Technical Design Document [pdf] by Jtsummers on Wednesday July 06, 2016 @02:43PM (#12045027)
It also made some puzzles much simpler. Have to navigate around 20 half-walls zigzagging over a pool of lava? That was a breeze. In Portal you only get line-of-sight, meaning you had to create a pair of portals, step through, repeat. The same puzzle would have been much more challenging in Portal.
Re:Narbacular Drop Technical Design Document [pdf] by Negative1 on Wednesday July 06, 2016 @04:25PM (#12045659)
"RECODE", ha, cute.

Short and to the point, it's a good doc but not very interesting. Just glad they didn't pad it with tons of code (last I remember Digipen TDD's are required as part of the curriculum and students are known for doing this).

Haven't thought about this game in years, though. What a nice throwback. I thought Portal was great, very polished with great sense of humor but ND was in my opinion a much more fun and interesting game experience (the puzzles really gave you that fantastic "aha!" moment).

Re:Narbacular Drop Technical Design Document [pdf] by newobj on Wednesday July 06, 2016 @03:48PM (#12045390)
Nice piece of history, and hilariously/sweetly innocent/naive in its specificity and certainty, like only newbies' first "design document" could be.
Re:Narbacular Drop Technical Design Document [pdf] by teamonkey on Wednesday July 06, 2016 @04:50PM (#12045814)
I have issues with this 'longform word doc' format of design documentation in general. It's tedious, no-one bothers to do more than skim read it, it conveys method but not intentions, etc.
Re:Narbacular Drop Technical Design Document [pdf] by CamperBob2 on Wednesday July 06, 2016 @05:29PM (#12046017)
I assume this was a class assignment or project, wasn't it? The format was probably dictated by DigiPen instructors.
Re:Narbacular Drop Technical Design Document [pdf] by teamonkey on Wednesday July 06, 2016 @08:23PM (#12046765)
Yeah. I'm not sure if Digipen still teaches it but I know others do, unfortunately.
Re:Narbacular Drop Technical Design Document [pdf] by fattire on Thursday July 07, 2016 @01:34AM (#12047631)
For those who haven't played it, the original game is here:

http://www.nuclearmonkeysoftware.com/narbaculardrop.html

Re:Narbacular Drop Technical Design Document [pdf] by rehevkor5 on Wednesday July 06, 2016 @03:18PM (#12045215)
Too bad there's nothing about handling recursion of the portal rendering.
Re:Narbacular Drop Technical Design Document [pdf] by bananaoomarang on Wednesday July 06, 2016 @04:46PM (#12045791)
This is actually in the developer commentary for the game, I seem to remember.
Re:Narbacular Drop Technical Design Document [pdf] by qmalzp on Wednesday July 06, 2016 @05:14PM (#12045944)
Page 19 seems to address this a bit.
Re:Narbacular Drop Technical Design Document [pdf] by verbatim on Wednesday July 06, 2016 @02:53PM (#12045075)
Very cool. Are there similar documents available for any other games that we would be familiar with?

I imagine it could be a pretty interesting exercise to read over a handful of these from different teams.

Re:Narbacular Drop Technical Design Document [pdf] by corysama on Wednesday July 06, 2016 @03:00PM (#12045117)
https://www.reddit.com/r/TheMakingOfGames/ collects a lot of this kind of material. Use the search function for "doc", "document" and "documents" to find a bunch of them.