create node settlement extension

This extension can be used to decide where to attach a newly created
node.
is this a runtime exception or a logicexception, or? a phpdoc to help people who see this thrown would be nice too.