refactor and inprove JavaDocs for weapons and traps